ConfigTranslator 函数

  • 项目

一致性
引入的版本：ODBC 2.0

摘要
ConfigTranslator 返回翻译器的默认翻译选项。 它可以位于翻译 DLL 中，也可以位于单独的安装 DLL 中。

语法

  
BOOL ConfigTranslator(  
     HWND     hwndParent,  
     DWORD *  pvOption);

参数

hwndParent
[输入]父窗口句柄。 如果句柄为 null，函数将不会显示任何对话框。

pvOption
[输出]32 位转换选项。

返回

如果成功，函数将返回 TRUE;如果失败，则返回 FALSE。

诊断

当 ConfigTranslator 返回 FALSE 时，通过调用 SQLPostInstallerError 会将关联的 *pfErrorCode 值发布到安装程序错误缓冲区，并且可以通过调用 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