SQLGetConnectOption のマッピング

アプリケーションが ODBC 3.x ドライバーを介して SQLGetConnectOption を呼び出すと、

SQLGetConnectOption(hdbc, fOption, pvParam)   

は次のようにマップされます。

• fOption が文字列を返す ODBC で定義された接続オプションを示す場合、ドライバー マネージャーは を呼び出します。

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

• fOption が 32 ビット整数値を返す ODBC で定義された接続オプションを示す場合、ドライバー マネージャーは を呼び出します。

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

• fOption がドライバー定義ステートメント オプションを示す場合、ドライバー マネージャーは を呼び出します。

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

上記の 3 つの場合、 ConnectionHandle 引数は hdbc の値に設定され、 Attribute 引数は fOption の値に設定され、 ValuePtr 引数は pvParam と同じ値に設定されます。

ODBC で定義された文字列接続文字列オプションの場合、ドライバー マネージャーは、SQLGetConnectAttr の呼び出しの BufferLength 引数を定義済みの最大長 (SQL_MAX_OPTION_STRING_LENGTH) に設定します。文字列以外の接続オプションの場合、BufferLength は 0 に設定されます。

ODBC 3.x ドライバーの場合、ドライバー マネージャーは オプション がSQL_CONN_OPT_MINとSQL_CONN_OPT_MAXの間にあるか、SQL_CONNECT_OPT_DRVR_STARTより大きいかどうかを確認しなくなりました。 ドライバーは、オプション値の有効性を確認する必要があります。