共用方式為

配置連線控制代碼 ODBC

  • 發行項

應用程式必須先配置連線控制代碼，才能夠連線到資料來源或驅動程式，如下所述：

  1. 應用程式宣告 SQLHDBC 類型的變數。 接下來，它會呼叫 SQLAllocHandle 並傳遞此變數的位址、用來配置連線的環境控制代碼和 SQL_HANDLE_DBC 選項。 例如：

    SQLHDBC hdbc1;  

SQLAllocHandle(SQL_HANDLE_DBC, henv1, &hdbc1);

  2. 驅動程式管理員會配置一個結構來儲存陳述式的相關資訊，並在變數中傳回連線控制代碼。

驅動程式管理員目前還不會在驅動程式中呼叫 SQLAllocHandle，因為它不知道要呼叫哪一個驅動程式。 它會等到應用程式呼叫函式而連線到資料來源之後，才在驅動程式中呼叫 SQLAllocHandle。 如需詳細資訊，請參閱本節稍後的驅動程式管理員在連線流程中的角色。

請務必注意，配置連線控制代碼和載入驅動程式的過程不同。 在呼叫連線函式之前，驅動程式不會載入。 因此，在配置連線控制代碼之後，和在連線至驅動程式或資料來源之前，應用程式唯一可以利用連線控制代碼呼叫的函式，只有 SQLSetConnectAttr、SQLGetConnectAttr 或具有 SQL_ODBC_VER 選項的 SQLGetInfo。 使用連線控制代碼呼叫其他函式 (如 SQLEndTran) 時，會傳回 SQLSTATE 08003 (連線未開啟)。 如需完整的詳細資訊，請參閱附錄 B：ODBC 狀態轉換資料表。

如需連線控制代碼的詳細資訊，請參閱連線控制代碼。