Argomenti funzione Unicode
Gestione driver ODBC 3.5 (o versione successiva) supporta sia la versione ANSI che Unicode di tutte le funzioni che accettano puntatori a stringhe di caratteri o SQLPOINTER nei relativi argomenti. Le funzioni Unicode vengono implementate come funzioni (con un suffisso W), non come macro. Le funzioni ANSI (che possono essere chiamate con o senza un suffisso A) sono identiche alle funzioni API ODBC correnti.
Osservazioni:
Per le funzioni Unicode che restituiscono o accettano sempre stringhe o argomenti di lunghezza, gli argomenti vengono passati come conteggio dei caratteri. Per le funzioni che restituiscono informazioni sulla lunghezza per i dati del server, le dimensioni e la precisione di visualizzazione sono descritte in numero di caratteri. Quando una lunghezza (dimensioni di trasferimento dei dati) può fare riferimento a dati di stringa o non di stringa, la lunghezza viene descritta in lunghezze di ottetti. Ad esempio, SQLGetInfoW prenderà comunque la lunghezza come conteggio dei byte, ma SQLExecDirectW userà il conteggio dei caratteri.
Il conteggio dei caratteri fa riferimento al numero di byte (ottetti) per le funzioni ANSI e al numero di WCHAR (parole a 16 bit) per le funzioni UNICODE. In particolare, una sequenza di caratteri a byte doppio (DBCS) o una sequenza di caratteri multibyte (MBCS) possono essere composte da più byte. Una sequenza di caratteri Unicode UTF-16 può essere costituita da più WCHAR.
Di seguito è riportato un elenco delle funzioni API ODBC che supportano sia la versione Unicode (W) che 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
Di seguito è riportato un elenco delle funzioni API del programma di installazione ODBC e del convertitore ODBC che supportano sia la versione Unicode (W) che ANSI (A):
SQLConfigDataSource
SQLCreateDataSource
SQLDataSourceToDriver
SQLDriverToDataSource
SQLGetAvailableDrivers
SQLGetInstalledDrivers
SQLGetTranslator
SQLInstallDriver
SQLInstallDriverManager
SQLInstallerError
SQLInstallODBC
SQLReadFileDSN
SQLRemoveDSNFromINI
SQLValidDSN
SQLWriteDSNToINI
Nota
Le funzioni deprecate supportano il mapping Unicode-ANSI perché Gestione driver ODBC 3.x supporta la ricompilazione delle applicazioni ODBC 2.x con il #define UNICODE.
Questa sezione descrive gli argomenti seguenti: