共用方式為

ConfigTranslator 函式

  • 發行項

一致性
引進的版本：ODBC 2.0

摘要
ConfigTranslator 會傳回翻譯工具的預設翻譯選項。 它可以位於翻譯工具 DLL 或個別的安裝 DLL 中。

語法

  
BOOL ConfigTranslator(  
     HWND     hwndParent,  
     DWORD *  pvOption);

引數

hwndParent
[輸入]父視窗控制碼。 如果控制碼為 Null，函式將不會顯示任何對話方塊。

pvOption
[輸出]32 位翻譯選項。

傳回

如果函式成功，則傳回 TRUE，如果失敗，則傳回 FALSE。

診斷

當 ConfigTranslator 傳回 FALSE 時 ，相關聯的 *pfErrorCode 值會透過對 SQLPostInstallerError 的呼叫 張貼到安裝程式錯誤緩衝區，而且可以藉由呼叫 SQLInstallerError 來取得。 下表列出 SQLInstallerError 可傳 回的 *pfErrorCode 值，並說明此函式內容中的每個值。

*pfErrorCode 錯誤 描述
ODBC_ERROR_INVALID_HWND 不正確視窗控制碼 hwndParent 引數無效或 Null。
ODBC_ERROR_DRIVER_SPECIFIC 驅動程式或翻譯工具特定的錯誤 驅動程式特定的錯誤，沒有定義的 ODBC 安裝程式錯誤。 SQLPostInstallerError 函式呼叫 中的 SzError 引數應該包含驅動程式特定的錯誤訊息。
ODBC_ERROR_INVALID_OPTION 不正確翻譯選項 pvOption 引數包含不正確值。

註解

如果翻譯工具只支援單一翻譯選項， ConfigTranslator 會傳回 TRUE，並將 pvOption 設定 為 32 位選項。 否則，它會決定要使用的預設翻譯選項。 ConfigTranslator 可以顯示對話方塊，讓使用者選取預設翻譯選項。

如需下列資訊 請參閱
取得翻譯選項 SQLGetConnectAttr
選取翻譯工具 SQLGetTranslator
設定翻譯選項 SQLSetConnectAttr