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