Argumentos da função Unicode
O Gerenciador de Driver ODBC 3.5 (ou superior) dá suporte às versões ANSI e Unicode de todas as funções que aceitam ponteiros para cadeias de caracteres ou SQLPOINTER nos argumentos. As funções Unicode são implementadas como funções (com um sufixo de W), não como macros. As funções ANSI (que podem ser chamadas com ou sem um sufixo de A) são idênticas às funções atuais da API ODBC.
Comentários
Para as funções Unicode que sempre retornam ou usam cadeias de caracteres ou argumentos de comprimento, os argumentos são passados como contagem de caracteres. Para as funções que retornam informações de comprimento para dados do servidor, o tamanho e a precisão de exibição são descritos em número de caracteres. Quando um comprimento (tamanho de transferência dos dados) pode ou não se referir a dados de cadeia de caracteres, o comprimento é descrito em comprimentos de octeto. Por exemplo, SQLGetInfoW ainda terá o comprimento como contagem de bytes, mas SQLExecDirectW usará contagem de caracteres.
Contagem de caracteres se refere ao número de bytes (octetos) para funções ANSI e o número de WCHAR (palavras de 16 bits) para funções UNICODE. Em particular, uma sequência de caracteres de byte duplo (DBCS) ou uma sequência de caracteres multibyte (MBCS) pode ser composta por vários bytes. Uma sequência de caracteres Unicode UTF-16 pode ser composta por vários WCHARs.
A seguir está uma lista das funções da API ODBC que dão suporte às versões Unicode (W) e 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
A seguir está uma lista das funções ODBC Installer e ODBC Translator que dão suporte às versões Unicode (W) e ANSI (A):
SQLConfigDataSource
SQLCreateDataSource
SQLDataSourceToDriver
SQLDriverToDataSource
SQLGetAvailableDrivers
SQLGetInstalledDrivers
SQLGetTranslator
SQLInstallDriver
SQLInstallDriverManager
SQLInstallerError
SQLInstallODBC
SQLReadFileDSN
SQLRemoveDSNFromINI
SQLValidDSN
SQLWriteDSNToINI
Observação
As funções preteridas têm suporte a mapeamento Unicode para ANSI porque o Gerenciador de Driver ODBC 3.x dá suporte à recompilação de aplicativos ODBC 2.x com o #define UNICODE.
Esta seção contém os tópicos a seguir.