Freigeben über


SQLGetConnectOption-Zuordnung

Wenn eine Anwendung SQLGetConnectOption über einen ODBC 3.x-Treiber aufruft , wird der Aufruf von

SQLGetConnectOption(hdbc, fOption, pvParam)   

wird wie folgt zugeordnet:

  • Wenn fOption eine von ODBC definierte Verbindungsoption angibt, die eine Zeichenfolge zurückgibt, ruft der Treiber-Manager auf.

    SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, BufferLength, NULL)  
    
  • Wenn fOption eine von ODBC definierte Verbindungsoption angibt, die einen 32-Bit-Ganzzahlwert zurückgibt, ruft der Treiber-Manager auf.

    SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, 0, NULL)  
    
  • Wenn fOption eine vom Treiber definierte Anweisungsoption angibt, ruft der Treiber-Manager auf.

    SQLGetConnectAttr(ConnectionHandle, Attribute, ValuePtr, BufferLength, NULL)  
    

In den vorherigen drei Fällen wird das Argument ConnectionHandle auf den Wert in hdbc, das Attributargument auf den Wert in fOption und das ValuePtr-Argument auf den gleichen Wert wie pvParam festgelegt.

Für ODBC-definierte Zeichenfolgenverbindungsoptionen legt der Treiber-Manager das BufferLength-Argument im Aufruf von SQLGetConnectAttr auf die vordefinierte maximale Länge (SQL_MAX_OPTION_STRING_LENGTH) fest. Für eine Verbindungsoption ohne Zeichenfolge ist BufferLength auf 0 festgelegt.

Bei einem ODBC 3.x-Treiber überprüft der Treiber-Manager nicht mehr, ob Option zwischen SQL_CONN_OPT_MIN und SQL_CONN_OPT_MAX liegt oder größer als SQL_CONNECT_OPT_DRVR_START ist. Der Treiber muss die Gültigkeit der Optionswerte überprüfen.