| description | SQLGetConnectOption Mapping | ||
|---|---|---|---|
| title | SQLGetConnectOption Mapping | Microsoft Docs | ||
| ms.custom | |||
| ms.date | 01/19/2017 | ||
| ms.prod | sql | ||
| ms.prod_service | connectivity | ||
| ms.reviewer | |||
| ms.technology | connectivity | ||
| ms.topic | reference | ||
| helpviewer_keywords |
|
||
| ms.assetid | e3792fe4-a955-473a-a297-c1b2403660c4 | ||
| author | David-Engel | ||
| ms.author | v-daenge |
When an application calls SQLGetConnectOption through an ODBC 3.x driver, the call to
SQLGetConnectOption(hdbc, fOption, pvParam)
is mapped as follows:
-
If fOption indicates an ODBC-defined connection option that returns a string, the Driver Manager calls
SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, BufferLength, NULL) -
If fOption indicates an ODBC-defined connection option that returns a 32-bit integer value, the Driver Manager calls
SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, 0, NULL) -
If fOption indicates a driver-defined statement option, the Driver Manager calls
SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, BufferLength, NULL)
In the preceding three cases, the ConnectionHandle argument is set to the value in hdbc, the Attribute argument is set to the value in fOption, and the ValuePtr argument is set to the same value as pvParam.
For ODBC-defined string connection options, the Driver Manager sets the BufferLength argument in the call to SQLGetConnectAttr to the predefined maximum length (SQL_MAX_OPTION_STRING_LENGTH); for a nonstring connection option, BufferLength is set to 0.
For an ODBC 3.x driver, the Driver Manager no longer checks to see if Option is in between SQL_CONN_OPT_MIN and SQL_CONN_OPT_MAX, or is greater than SQL_CONNECT_OPT_DRVR_START. The driver must check the validity of the option values.