Поделиться через


Функция SQLGetConfigMode

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

Сводка
SQLGetConfigMode извлекает режим конфигурации, указывающий, где запись Odbc.ini содержит значения DSN в системной информации.

Синтаксис

  
BOOL SQLGetConfigMode(  
     UWORD *   pwConfigMode);  

Аргументы

pwConfigMode
[Выходные данные] Указатель на буфер, содержащий режим конфигурации. (См. комментарии.) Значение в *pwConfigMode может быть следующим:

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

Возвраты

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

Диагностика

Когда SQLGetConfigMode возвращает ЗНАЧЕНИЕ FALSE, связанное значение *pfErrorCode можно получить путем вызова SQLInstallerError. В следующей таблице перечислены значения *pfErrorCode , которые можно возвращать SQLInstallerError и объясняет каждый из них в контексте этой функции.

*pfErrorCode Error Description
ODBC_ERROR_OUT_OF_MEM Недостаточно памяти Установщик не мог выполнить функцию из-за нехватки памяти.

Комментарии

Эта функция используется для определения того, где в системной информации содержатся значения DSN в записи Odbc.ini. Если *pwConfigMode ODBC_USER_DSN, dsN — это имя пользователя, а функция считывается из записи Odbc.ini в HKEY_CURRENT_USER. Если это ODBC_SYSTEM_DSN, dsN — это системное доменное имя, а функция считывается из записи Odbc.ini в HKEY_LOCAL_MACHINE. Если это ODBC_BOTH_DSN, то HKEY_CURRENT_USER пробуется и используется HKEY_LOCAL_MACHINE.

По умолчанию SQLGetConfigMode возвращает ODBC_BOTH_DSN. Если пользовательская dsN или системная dsN создается вызовом SQLConfigDataSource, функция задает режим конфигурации для ODBC_USER_DSN или ODBC_SYSTEM_DSN для различения доменных имен пользователей и системных доменных имен при изменении имени DSN. Перед возвратом SQLConfigDataSource сбрасывает режим конфигурации на ODBC_BOTH_DSN.

Сведения Раздел
Настройка режима конфигурации SQLSetConfigMode