ID do artigo: 294169 - �ltima revis�o: segunda-feira, 12 de maio de 2003 - Revis�o: 2.1

DOC: Explica��o de argumentos de comprimento para fun��es ODBC Unicode

Clique aqui para exibir o artigo traduzido e o artigo original em ingl�s, lado a lado.

Exibir Aviso de Isen��o de Tradu��o Autom�tica

Exibir os produtos aos quais esse artigo se aplica.

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que est� a utilizar. Foi desactivado o conte�do do artigo, que pode n�o ser relevante para si.

Expandir tudo | Recolher tudo

Sum�rio

O Gerenciador de driver ODBC vers�o 3.5 ou posterior suporta vers�es ANSI e Unicode de todas as fun��es que aceitam ponteiros para as seq��ncias de caracteres ou SQLPOINTER em seus argumentos. As fun��es do Unicode s�o implementadas como fun��es com um sufixo de "W", como SQLExecDirectW e SQLGetInfoW .

Para muitas dessas fun��es de Unicode, refer�ncia do programador ODBC fornece descri��es incorretas ou amb�guas para alguns argumentos de fun��o. Especificamente, esse problema se relaciona com argumentos que s�o usados para especificar o comprimento do caractere seq��ncia valores de entrada e sa�das.

Voltar para o in�cio

Mais Informa��es

Os problemas na documenta��o do ODBC envolvem se um argumento de comprimento deve especificar o n�mero de bytes ou o n�mero de caracteres em uma seq��ncia de entrada ou sa�da. Para a vers�o ANSI dessas fun��es, a contagem de bytes em uma seq��ncia de caracteres � igual a contagem de caracteres (como caracteres ANSI ocupam apenas um byte cada), para que os termos "bytes" e "caracteres" possam efetivamente ser usados alternadamente. No entanto, com as cadeias de caracteres Unicode, cada caractere ocupa dois bytes. Portanto, � muito importante distinguir se entradas de comprimento para uma fun��o Unicode devem especificar uma contagem de bytes ou de caracteres.

Em alguns casos, a documenta��o usa a palavra "bytes" quando a palavra "caracteres" deve ter sido usada em vez disso. Em outros casos, a documenta��o n�o � necessariamente incorreta, mas Especifica que um "comprimento" de uma seq��ncia de caracteres � necess�rio, sem documentar explicitamente se esse valor deve ser uma contagem de bytes ou uma contagem de caracteres.

Independentemente do que a documenta��o diz para cada fun��o ODBC, o par�grafo seguinte da se��o de "Cap�tulo 17: programa��o considera��es" na refer�ncia do programador de ODBC Unicode � a regra definitiva para usar para argumentos de comprimento em fun��es do Unicode:

"Fun��es de Unicode que sempre retornam ou seq��ncias de caracteres ou comprimento argumentos s�o passadas como contagem de caracteres. Para fun��es que retornam informa��es de comprimento de dados do servidor, o tamanho de exibi��o e precis�o s�o descritos em n�mero de caracteres. Quando um comprimento (tamanho de transfer�ncia dos dados) pode se referir a seq��ncia de caracteres ou nonstring dados, o comprimento � descrito em comprimento do octeto. Por exemplo, SQLGetInfoW ainda ter�o o comprimento de contagem de bytes, mas SQLExecDirectW usar� a contagem de caracteres."

Isso significa que, se o argumento em quest�o descreve o comprimento do outro argumento � sempre uma seq��ncia de caracteres (normalmente representada por um SQLCHAR), e o comprimento reflete o n�mero de caracteres na seq��ncia. Se o argumento de comprimento descreve outro argumento pode ser uma seq��ncia de caracteres ou algum outro tipo de dados (normalmente representado por um SQLPOINTER), o comprimento � em bytes.

A tabela a seguir lista todas as fun��es API ODBC que possuem as vers�es do Unicode. Para cada fun��o listada, a tabela destaca os problemas conhecidos na documenta��o do ODBC e fornece uma descri��o mais completa dos argumentos de comprimento em quest�o.

Recolher esta tabelaExpandir esta tabela

Fun��o	Nome de argumento	Descri��o atual	Descri��o corrigida
SQLBrowseConnect	StringLength1	Comprimento de * InConnectionString.	Comprimento de * InConnectionString, em caracteres.
	BufferLength	Comprimento do * OutConnectionString buffer.	Comprimento do * OutConnectionString buffer, em caracteres.
	StringLength2Ptr	O n�mero total de bytes (excluindo o byte de termina��o nula) dispon�veis para retornar em * OutConnectionString.	O n�mero total de caracteres (excluindo o caractere de termina��o nula) dispon�veis para retornar em * OutConnectionString.
SQLColAttribute	BufferLength	Se FieldIdentifier � um campo definido pelo ODBC e CharacterAttributePtr aponta para uma seq��ncia de caracteres ou buffer bin�rio, esse argumento dever� ser o tamanho de * CharacterAttributePtr. Se FieldIdentifier for um campo definido pelo ODBC e * CharacterAttributePtr � um n�mero inteiro, este campo � ignorado. Se o * CharacterAttributePtr � uma seq��ncia de caracteres Unicode (ao chamar SQLColAttributeW), o argumento BufferLength deve ser um n�mero par	Isso est� correto. BufferLength se refere ao n�mero de bytes dispon�veis para o valor no CharacterAttributePtr.
	StringLengthPtr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo a finaliza��o null do byte de dados de caracteres) dispon�veis para retornar em * CharacterAttributePtr.	Isso est� correto.
SQLColAttributes	Essa fun��o como foi substitu�da para SQLColAttribute (veja acima).
SQLColumnPrivileges	NameLength1-4	Comprimento de * CatalogName. (Observe aqui que h� quatro argumentos diferentes que cont�m valores de comprimento. Cada um deles se refere a uma entrada diferente ou buffer de sa�da, como CatalogName, SchemaName, TableName e ColumnName. Para simplificar, para todas as fun��es com valores de entrada semelhantes, este tabelas combina todos os argumentos tais NameLength, em vez de listar cada um deles separadamente.)	Comprimento de * CatalogName, em caracteres.
SQLColumns	NameLength1-4	Comprimento de * CatalogName.	Comprimento de * CatalogName, em caracteres.
SQLConnect	NameLength1-3	Comprimento de * nomedoservidor.	Comprimento de * NomeDoServidor, em caracteres.
SQLDataSources	BufferLength1	Comprimento do * nome_do_servidor buffer, em bytes.	Comprimento do * nome_do_servidor buffer, em caracteres.
	NameLength1Ptr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o byte de termina��o nula).	Ponteiro para um buffer no qual retornar o n�mero total de caracteres (excluindo o caractere de termina��o nula).
	BufferLength2	Comprimento do * descri��o buffer.	Comprimento do * buffer descri��o, em caracteres.
	NameLength2Ptr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o byte de termina��o nula) dispon�veis para retornar em * Descri��o.	Ponteiro para um buffer no qual retornar o n�mero total de caracteres (excluindo o caractere de termina��o nula) dispon�veis para retornar em * Descri��o.
SQLDescribeCol	BufferLength	Comprimento do * ColumnName buffer, em caracteres.	Isso est� correto.
	NameLengthPtr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o byte de termina��o nula) dispon�veis para retornar em * ColumnName.	Ponteiro para um buffer no qual retornar o n�mero total de caracteres (excluindo o caractere de termina��o nula) dispon�veis para retornar em * ColumnName.
SQLDriverConnect	StringLength1	Comprimento de * InConnectionString, em bytes.	Comprimento de * InConnectionString, em caracteres.
	BufferLength	Comprimento do * OutConnectionString buffer. Se o * OutConnectionString valor � uma seq��ncia de caracteres Unicode (ao chamar SQLDriverConnectW), o argumento BufferLength deve ser um n�mero par.	Comprimento do * OutConnectionString buffer, em caracteres. (Observe que isso significa que esse argumento n�o � necess�rio ser um n�mero par.)
	StringLength2Ptr	Ponteiro para um buffer no qual retornar o n�mero total de caracteres (excluindo o caractere de termina��o nula) dispon�veis para retornar em * OutConnectionString.	Isso est� correto.
SQLDrivers	BufferLength1	Comprimento do * DriverDescription buffer, em bytes.	Comprimento do * DriverDescription buffer, em caracteres.
	DescriptionLengthPtr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o byte de termina��o nula) dispon�veis para retornar em * DriverDescription.	Ponteiro para um buffer no qual retornar o n�mero total de caracteres (excluindo o caractere de termina��o nula) dispon�veis para retornar em * DriverDescription.
	BufferLength2	Comprimento do * DriverAttributes buffer, em bytes. Se o * DriverDescription valor � uma seq��ncia de caracteres Unicode (ao chamar SQLDriversW), o argumento BufferLength deve ser um n�mero par.	Comprimento do * DriverAttributes buffer, em caracteres. (Observe que isso significa que esse argumento n�o � necess�rio ser um n�mero par.)
	AttributesLengthPtr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o byte de termina��o nula) dispon�veis para retornar em * DriverAttributes.	Ponteiro para um buffer no qual retornar o n�mero total de caracteres (excluindo o caractere de termina��o nula) dispon�veis para retornar em * DriverAttributes.
SQLError	Esta fun��o foi substitu�da para SQLGetDiagRec.
SQLExecDirect	TextLength	Comprimento de * StatementText.	Comprimento de * StatementText, em caracteres.
SQLForeignKeys	NameLength1 2	Comprimento de * PKCatalogName, em bytes.	Comprimento de * PKCatalogName, em caracteres.
	NameLength3-6	Comprimento de * PKTableName.	Comprimento de * PKTableName, em caracteres.
SQLGetConnectAttr	BufferLength	Se o valor no * ValuePtr � uma seq��ncia de caracteres Unicode (ao chamar SQLGetConnectAttrW), o argumento BufferLength deve ser um n�mero par.	Isso est� correto. BufferLength deve conter uma contagem de bytes.
	StringLengthPtr	Um ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o caractere de termina��o nula) dispon�veis para retornar em * ValuePtr.	Isso est� correto.
SQLGetConnectOption	Esta fun��o foi substitu�da para SQLGetConnectAttr.
SQLGetCursorName	BufferLength	Comprimento de * CursorName, em bytes. Se o valor no * CursorName � uma seq��ncia de caracteres Unicode (ao chamar SQLGetCursorNameW), o argumento BufferLength deve ser um n�mero par.	Comprimento de * CursorName, em caracteres. (Observe que isso significa que esse argumento n�o � necess�rio ser um n�mero par.)
	NameLengthPtr	Ponteiro para a mem�ria retornar o n�mero total de bytes (excluindo o caractere de termina��o nula) dispon�veis para retornar em * CursorName.	Ponteiro para a mem�ria retornar o n�mero total de caracteres (excluindo o caractere de termina��o nula) dispon�veis para retornar em * CursorName.
SQLGetDescField	BufferLength	Se o valor no * ValuePtr � de um tipo de dados Unicode (ao chamar SQLGetDescFieldW), o argumento BufferLength deve ser um n�mero par.	Isso est� correto. BufferLength deve conter uma contagem de bytes.
	StringLengthPtr	Ponteiro para o buffer no qual retornar o n�mero total de bytes (excluindo o n�mero de bytes necess�rios para o caractere de termina��o nula) dispon�veis para retornar em * ValuePtr.	Isso est� correto.
SQLGetDescRec	BufferLength	Comprimento do * buffer de nome, em bytes.	Comprimento do * buffer de nome, em caracteres.
	StringLengthPtr	Um ponteiro para um buffer no qual retornar o n�mero de bytes de dados dispon�veis para retornar o * buffer de nome, excluindo o caractere de finaliza��o null.	Um ponteiro para um buffer no qual retornar o n�mero de caracteres dispon�veis para retornar o * buffer de nome, excluindo o caractere de finaliza��o null.
SQLGetDiagField	BufferLength	Se o valor no * DiagInfoPtr � uma seq��ncia de caracteres Unicode (ao chamar SQLGetDiagFieldW), o argumento BufferLength deve ser um n�mero par.	Isso est� correto. BufferLength deve conter uma contagem de bytes.
	StringLengthPtr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o n�mero de bytes necess�rios para o caractere de termina��o nula) dispon�veis para retornar em * DiagInfoPtr, para dados de caracteres.	Isso est� correto.
SQLGetDiagRec	BufferLength	Comprimento do * MessageText buffer em caracteres.	Isso est� correto
	TextLengthPtr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o n�mero de bytes necess�rios para o caractere de termina��o nula) dispon�veis para retornar em * MessageText.	Ponteiro para um buffer no qual retornar o n�mero total de caracteres (excluindo o caractere de termina��o nula) dispon�veis para retornar em * MessageText.
SQLGetInfo	BufferLength	Comprimento do * InfoValuePtr buffer. Se * InfoValuePtr � uma seq��ncia de caracteres Unicode (ao chamar SQLGetInfoW), o argumento BufferLength deve ser um n�mero par.	Isso est� correto. BufferLength deve conter uma contagem de bytes.
	StringLengthPtr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o caractere de termina��o nula para dados de caractere) dispon�veis para retornar em * InfoValuePtr.	Isso est� correto.
SQLGetStmtAttr	BufferLength	Se o atributo � um atributo definido pelo ODBC e ValuePtr aponta para uma seq��ncia de caracteres ou um buffer bin�rio, este argumento deve ser o comprimento do * ValuePtr. Se o valor retornado no * ValuePtr � uma seq��ncia de caracteres Unicode (ao chamar SQLGetStmtAttrW), o argumento BufferLength deve ser um n�mero par	Isso est� correto. BufferLength deve conter uma contagem de bytes.
	StringLengthPtr	Um ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o caractere de termina��o nula) dispon�veis para retornar em * ValuePtr.	Isso est� correto.
SQLNativeSQL	TextLength1	Comprimento de * InStatementText seq��ncia de caracteres de texto.	Comprimento de * InStatementText seq��ncia de texto, em caracteres.
	BufferLength	Comprimento do * OutStatementText buffer. Se o valor retornado no * InStatementText � uma seq��ncia de caracteres Unicode (ao chamar SQLNativeSqlW), o argumento BufferLength deve ser um n�mero par.	Comprimento do * OutStatementText buffer, em caracteres. (Observe que isso significa que esse argumento n�o � necess�rio ser um n�mero par.)
	TextLength2Ptr	Ponteiro para um buffer no qual retornar o n�mero total de bytes (excluindo o byte de termina��o nula) dispon�veis para retornar em * OutStatementText.	Ponteiro para um buffer no qual retornar o n�mero total de caracteres (excluindo o caractere de termina��o nula) dispon�veis para retornar em * OutStatementText.
SQLPrepare	TextLength	Comprimento de * StatementText.	Comprimento de * StatementText, em caracteres.
SQLPrimaryKeys	NameLength1-3	Comprimento em bytes de * CatalogName.	Comprimento de * CatalogName, em caracteres.
SQLProcedureColumns	NameLength1-4	Comprimento de * CatalogName.	Comprimento de * CatalogName, em caracteres.
SQLProcedures	NameLength1-3	Comprimento em bytes de * CatalogName.	Comprimento de * CatalogName, em caracteres.
SQLSetConnectAttr	StringLength	Se o atributo � um atributo definido pelo ODBC e ValuePtr aponta para uma seq��ncia de caracteres ou um buffer bin�rio, este argumento deve ser o comprimento do * ValuePtr.	Se o atributo � um atributo definido pelo ODBC e ValuePtr aponta para uma seq��ncia de caracteres ou um buffer bin�rio, este argumento deve ser o comprimento do * ValuePtr. Para dados de seq��ncia de caracteres, esse argumento deve conter o n�mero de bytes na seq��ncia de caracteres.
SQLSetConnectOption	Esta fun��o foi substitu�da para SQLSetConnectAttr.
SQLSetCursorName	NameLength	Comprimento de * CursorName.	Comprimento de * CursorName, em caracteres.
SQLSetDescField	BufferLength	Se FieldIdentifier � um campo definido pelo ODBC e ValuePtr aponta para uma seq��ncia de caracteres ou um buffer bin�rio, esse argumento dever� ser o tamanho de * ValuePtr.	Se FieldIdentifier � um campo definido pelo ODBC e ValuePtr aponta para uma seq��ncia de caracteres ou um buffer bin�rio, esse argumento dever� ser o tamanho de * ValuePtr. Para dados de seq��ncia de caracteres, esse argumento deve conter o n�mero de bytes na seq��ncia de caracteres.
SQLSetStmtAttr	StringLength	Se o atributo � um atributo definido pelo ODBC e ValuePtr aponta para uma seq��ncia de caracteres ou um buffer bin�rio, este argumento deve ser o comprimento do * ValuePtr.	Se o atributo � um atributo definido pelo ODBC e ValuePtr aponta para uma seq��ncia de caracteres ou um buffer bin�rio, este argumento deve ser o comprimento do * ValuePtr. Para dados de seq��ncia de caracteres, esse argumento deve conter o n�mero de bytes na seq��ncia de caracteres.
SQLSpecialColumns	NameLength1-3	Comprimento de * TableName.	Comprimento de * TableName, em caracteres.
SQLStatistics	NameLength1-3	Comprimento de * CatalogName.	Comprimento de * CatalogName, em caracteres.
SQLTablePrivileges	NameLength1-3	Comprimento de * CatalogName.	Comprimento de * CatalogName, em caracteres.
SQLTables	NameLength1-4	Comprimento de * CatalogName.	Comprimento de * CatalogName, em caracteres.

Usando o exemplo SQLDriverConnect da tabela acima, os argumentos InConnectionString e OutConnectionString s�o ambos definidos como SQLCHAR 1, para que StringLength1 e BufferLength devem indicar o n�mero de caracteres em seq��ncias. Por outro lado, considere a fun��o SQLGetInfo . Esta fun��o tem uma entrada de InfoValuePtr e o comprimento dessa entrada � passado no BufferLength . Como InfoValuePtr pode conter seq��ncias de caracteres e outros tipos de dados, ele � um SQLPOINTER. Portanto, aplicar regras explicadas acima, BufferLength ser� uma contagem de bytes, em vez de caracteres.

Voltar para o in�cio

Refer�ncias

O seguinte artigo da Base de dados de Conhecimento da Microsoft cont�m informa��es sobre o problema acima que j� tenha sido corrigido da documenta��o SQLGetDiagRecW :

243526� (http://support.microsoft.com/kb/243526/EN-US/ ) DOC: ODBC espec incorretamente afirma SQLGetDiagRecW demora na Bufferlength como o n�mero de bytes

Voltar para o in�cio

A informa��o contida neste artigo aplica-se a:

Microsoft Open Database Connectivity 3.5
Microsoft Data Access Components 2.1
Microsoft Data Access Components 2.5
Microsoft Data Access Components 2.6
Microsoft Data Access Components 2.7

Voltar para o in�cio

kbmt kbbug kbdocerr KB294169 KbMtpt

Voltar para o in�cio

Tradu��o autom�tica

IMPORTANTE: Este artigo foi traduzido por um sistema de tradu��o autom�tica (tamb�m designado por Machine Translation ou MT), n�o tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplica��es (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em portugu�s a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradu��o autom�tica n�o � sempre perfeita, podendo conter erros de vocabul�rio, sintaxe ou gram�tica. A Microsoft n�o � respons�vel por incoer�ncias, erros ou preju�zos ocorridos em decorr�ncia da utiliza��o dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualiza��es freq�entes ao software de tradu��o autom�tica (MT). Obrigado.

Clique aqui para ver a vers�o em Ingl�s deste artigo: 294169� (http://support.microsoft.com/kb/294169/en-us/ )

Voltar para o in�cio

This site in other countries/regions:

DOC: Explica��o de argumentos de comprimento para fun��es ODBC Unicode

Sum�rio

Mais Informa��es

Refer�ncias

A informa��o contida neste artigo aplica-se a:

Palavras-chave:�

Outros Sites de Suporte

Comunidades

Tradu��es deste artigo