共用方式為


配置環境控制代碼

任何 ODBC 應用程式的第一項工作都是載入驅動程式管理員;如何完成此操作取決於作業系統。 例如,在執行 Microsoft Windows NT Server/Windows 2000 Server、Windows NT Workstation/Windows 2000 Professional 或 Microsoft Windows 95/98 的電腦上,應用程式會連結至驅動程式管理員程式庫,或呼叫 LoadLibrary 以載入驅動程式管理員 DLL。

下一項工作必須在應用程式呼叫其他 ODBC 函式之前完成,那就是初始化 ODBC 環境並配置環境控制代碼,如下所示:

  1. 應用程式會宣告 SQLHENV 類型的變數。 然後它會呼叫 SQLAllocHandle,並傳遞此變數的位址和 SQL_HANDLE_ENV 選項。 例如:

    SQLHENV henv1;  
    
    SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv1);  
    
  2. 驅動程式管理員會配置一個結構來儲存環境的相關資訊,並在變數中傳回環境控制代碼。

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

應用程式完成使用 ODBC 後,便會透過 SQLFreeHandle 釋放環境控制代碼。 釋放環境之後,在呼叫 ODBC 函式時使用環境的控制代碼,屬於應用程式的程式設計錯誤,這麼做可能導致未定義的嚴重結果。

在呼叫 SQLFreeHandle 時,驅動程式會釋放用於儲存環境相關資訊的結構。 請注意,必須釋放環境控制代碼上的所有連線控制代碼後,才能呼叫該環境控制代碼的 SQLFreeHandle

如需環境控制代碼的詳細資訊,請參閱環境控制代碼