共用方式為


配置連線控制代碼 ODBC

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

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

    SQLHDBC hdbc1;  
    
    SQLAllocHandle(SQL_HANDLE_DBC, henv1, &hdbc1);  
    
  2. 驅動程式管理員會配置一個結構來儲存陳述式的相關資訊,並在變數中傳回連線控制代碼。

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

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

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