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

Функция SQLWritePrivateProfileString

  • Статья

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

Сводка
SQLWritePrivateProfileString записывает имя значения и данные в Odbc.ini подраздел системной информации.

Синтаксис

  
BOOL SQLWritePrivateProfileString(  
     LPCSTR     lpszSection,  
     LPCSTR     lpszEntry,  
     LPCSTR     lpszString,  
     LPCSTR     lpszFilename);

Аргументы

lpszSection
[Входные данные] Указывает на строку, завершающую значение NULL, содержащую имя раздела, в который будет скопирована строка. Если раздел не существует, он создается. Имя раздела является независимым от регистра; Строка может быть любой комбинацией прописных и строчных букв.

lpszEntry
[Входные данные] Указывает на строку, завершающую значение NULL, содержащую имя ключа, связанного со строкой. Если ключ не существует в указанном разделе, он создается. Если этот аргумент имеет значение NULL, удаляется весь раздел, включая все записи в разделе.

lpszString
[Входные данные] Указывает на строку, завершаемую значением NULL, для записи в файл. Если этот аргумент имеет значение NULL, ключ, указывающий на аргумент lpszEntry , удаляется.

lpszFilename
[Выходные данные] Указывает на строку, завершающую значение NULL, которая называет файл инициализации.

Возвраты

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

Диагностика

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

*pfErrorCode Ошибка Описание
ODBC_ERROR_GENERAL_ERR Общая ошибка установщика Произошла ошибка, для которой не было определенной ошибки установщика.
ODBC_ERROR_REQUEST_FAILED Не удалось выполнить запрос Запрошенные системные сведения не могут быть записаны.
ODBC_ERROR_OUT_OF_MEM Недостаточно памяти Установщик не мог выполнить функцию из-за нехватки памяти.

Комментарии

SQLWritePrivateProfileString предоставляется как простой способ переноса драйверов и библиотек DLL драйверов из Microsoft Windows в Microsoft Windows в Microsoft NT/Windows 2000. Вызовы WritePrivateProfileString, которые записывают строку профиля в файл Odbc.ini, следует заменить вызовами SQLWritePrivateProfileString. SqlWritePrivateProfileString вызывает функции в API Win32, чтобы добавить указанное имя значения и данные в Odbc.ini подраздел системной информации.

Режим конфигурации указывает, где Odbc.ini записи, в которой перечислены значения DSN, содержатся в системной информации. Если dsN является доменным доменом пользователя (переменная состояния USERDSN_ONLY), функция записывает запись Odbc.ini в HKEY_CURRENT_USER. Если dsN является системным доменным доменным доменом (SYSTEMDSN_ONLY), функция записывается в запись Odbc.ini в HKEY_LOCAL_MACHINE. Если переменная состояния имеет значение BOTHDSN, HKEY_CURRENT_USER выполняется и при сбое используется HKEY_LOCAL_MACHINE.

Сведения Смотрите
Получение значения из системных сведений SQLGetPrivateProfileString