Функция ConfigTranslator

Соответствия
Представлена версия: ODBC 2.0

Сводка
ConfigTranslator возвращает параметр перевода по умолчанию для переводчика. Он может быть в библиотеке DLL переводчика или отдельной библиотеке установки.

Синтаксис

  
BOOL ConfigTranslator(  
     HWND     hwndParent,  
     DWORD *  pvOption);  

Аргументы

hwndParent
[Входные данные] Родительский дескриптор окна. Функция не будет отображать диалоговые окна, если дескриптор имеет значение NULL.

pvOption
[Выходные данные] 32-разрядный вариант перевода.

Возвраты

Функция возвращает значение TRUE, если оно выполнено успешно, значение FALSE, если оно завершается ошибкой.

Диагностика

Когда ConfigTranslator возвращает значение FALSE, связанное значение *pfErrorCode помещается в буфер ошибок установщика вызовом SQLPostInstallerError и может быть получено путем вызова SQLInstallerError. В следующей таблице перечислены значения *pfErrorCode , которые можно возвращать SQLInstallerError и объясняет каждый из них в контексте этой функции.

*pfErrorCode	Error	Description
ODBC_ERROR_INVALID_HWND	Недопустимый дескриптор окна	Недопустимый аргумент hwndParent или NULL.
ODBC_ERROR_DRIVER_SPECIFIC	Ошибка драйвера или переводчика	Ошибка для конкретного драйвера, для которой не определена ошибка установщика ODBC. Аргумент SzError в вызове функции SQLPostInstallerError должен содержать сообщение об ошибке для конкретного драйвера.
ODBC_ERROR_INVALID_OPTION	Недопустимый параметр перевода	Аргумент pvOption содержит недопустимое значение.

Комментарии

Если переводчик поддерживает только один параметр перевода, ConfigTranslator возвращает ЗНАЧЕНИЕ TRUE и задает pvOption 32-разрядному параметру. В противном случае он определяет используемый параметр перевода по умолчанию. ConfigTranslator может отображать диалоговое окно, с помощью которого пользователь выбирает параметр перевода по умолчанию.

Связанные функции

Сведения	Раздел
Получение параметра перевода	SQLGetConnectAttr
Выбор переводчика	SQLGetTranslator
Настройка параметра перевода	SQLSetConnectAttr