Partilhar via

Argumentos da função Unicode

O ODBC 3.5 (ou superior) Driver Manager suporta versões ANSI e Unicode de todas as funções que aceitam apontadores para cadeias de caracteres ou SQLPOINTER nos seus argumentos. As funções Unicode são implementadas como funções (com o sufixo W), não como macros. As funções ANSI (que podem ser chamadas com ou sem o sufixo A) são idênticas às funções atuais da API ODBC.

Observações

Para funções Unicode que sempre devolvem ou aceitam strings ou argumentos de comprimento, os argumentos são passados como número de caracteres. Para funções que retornam informação de comprimento para os dados do servidor, o tamanho e a precisão do ecrã são descritos em número de caracteres. Quando um comprimento (tamanho de transferência dos dados) pode referir-se a dados de cadeia ou não, o comprimento é descrito em comprimentos de octetos. Por exemplo, o SQLGetInfoW continuará a tomar o comprimento como contagem de bytes, mas o SQLExecDirectW usará contagem de caracteres.

Contagem de caracteres refere-se ao número de bytes (octetos) para funções ANSI e ao número de WCHAR (palavras de 16 bits) para funções UNICODE. Em particular, uma sequência de caracteres de dois bytes (DBCS) ou uma sequência de caracteres de vários bytes (MBCS) podem ser compostas por múltiplos bytes. Uma sequência de caracteres Unicode UTF-16 pode ser composta por múltiplos WCHARs.

Segue-se uma lista das funções da API ODBC que suportam tanto as versões Unicode (W) como ANSI (A):

SQLBrowseConnect
SQLColAttribute
SQLColAttributes
SQLColumnPrivileges
SQLColumns
SQLConnect
SQLDataSources
SQLDescribeCol
SQLDriverConnect
SQLDrivers
SQLError
SQLExecDirect
SQLForeignKeys
SQLGetConnectAttr
SQLGetConnectOption
SQLGetCursorName
SQLGetDescField
SQLGetDescRec
SQLGetDiagField

SQLGetDiagRec
SQLGetInfo
SQLGetStmtAttr
SQLGetTypeInfo
SQLNativeSQL
SQLPrepare
SQLPrimaryKeys
SQLProcedureColumns
SQLProcedures
SQLSetConnectAttr
SQLSetConnectOption
SQLSetCursorName
SQLSetDescField
SQLSetStmtAttr
SQLSpecialColumns
SQLStatistics
SQLTablePrivileges
SQLTables

Segue-se uma lista das funções do Instalador ODBC e do Tradutor ODBC que suportam tanto as versões Unicode (W) como ANSI (A):

SQLConfigDataSource
SQLCreateDataSource
SQLDataSourceToDriver
SQLDriverToDataSource
SQLGetAvailableDrivers
SQLGetInstalledDrivers
SQLGetTranslator
SQLInstallDriver

SQLInstallDriverManager
SQLInstallerError
SQLInstallODBC
SQLReadFileDSN
SQLRemoveDSNFromINI
SQLValidDSN
SQLWriteDSNToINI

Observação

Funções obsoletas têm suporte para mapeamento Unicode-para-ANSI porque o ODBC 3.x Driver Manager suporta a recompilação de aplicações ODBC 2.x com o #define UNICODE.

Esta seção contém os seguintes tópicos.

  • Last updated on