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 引数に無効な値が含まれていました。 |
説明
トランスレーターが 1 つの変換オプションのみをサポートしている場合、 ConfigTranslator は TRUE を返し、 pvOption を 32 ビット オプションに設定します。 それ以外の場合は、使用する既定の翻訳オプションが決定されます。 ConfigTranslator では、ユーザーが既定の翻訳オプションを選択するダイアログ ボックスを表示できます。
関連する関数
対象 | 解決方法については、 |
---|---|
翻訳オプションの取得 | SQLGetConnectAttr |
翻訳ツールの選択 | SQLGetTranslator |
翻訳オプションの設定 | SQLSetConnectAttr |