Argumentos de función de Unicode
El Administrador de controladores ODBC 3.5 (o superior) admite versiones ANSI y Unicode de todas las funciones que aceptan punteros a cadenas de caracteres o SQLPOINTER en sus argumentos. Las funciones Unicode se implementan como funciones (con un sufijo de W), no como macros. Las funciones ANSI (a las que se puede llamar con o sin un sufijo A) son idénticas a las funciones actuales de la API de ODBC.
Comentarios
Para las funciones Unicode que siempre devuelven o toman cadenas o argumentos de longitud, los argumentos se pasan como recuento de caracteres. En el caso de las funciones que devuelven información de longitud para los datos del servidor, el tamaño de visualización y la precisión se describen en el número de caracteres. Cuando una longitud (tamaño de transferencia de los datos) podría hacer referencia a datos de cadena o que no son de cadena, la longitud se describe en longitudes de octeto. Por ejemplo, SQLGetInfoW seguirá teniendo la longitud como recuento de bytes, pero SQLExecDirectW usará recuento de caracteres.
El recuento de caracteres hace referencia al número de bytes (octetos) para las funciones ANSI y el número de palabras WCHAR (palabras de 16 bits) para las funciones UNICODE. En concreto, una secuencia de caracteres de doble byte (DBCS) o una secuencia de caracteres multibyte (MBCS) se puede componer de varios bytes. Una secuencia de caracteres Unicode UTF-16 se puede componer de varios WCHAR.
A continuación se muestra una lista de las funciones de API odbc que admiten versiones Unicode (W) y 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 continuación se muestra una lista de las funciones del Instalador ODBC y del Traductor ODBC que admiten las versiones Unicode (W) y ANSI (A):
SQLConfigDataSource
SQLCreateDataSource
SQLDataSourceToDriver
SQLDriverToDataSource
SQLGetAvailableDrivers
SQLGetInstalledDrivers
SQLGetTranslator
SQLInstallDriver
SQLInstallDriverManager
SQLInstallerError
SQLInstallODBC
SQLReadFileDSN
SQLRemoveDSNFromINI
SQLValidDSN
SQLWriteDSNToINI
Nota:
Las funciones en desuso son compatibles con la asignación de Unicode a ANSI porque el Administrador de controladores ODBC 3.x admite la recompilación de aplicaciones ODBC 2.x con el UNICODE #define.
Esta sección contiene los temas siguientes.