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


Функция SHRegGetBoolUSValueA (shlwapi.h)

Извлекает логическое значение из подраздела реестра в пользовательском поддереве (HKEY_CURRENT_USER или HKEY_LOCAL_MACHINE).

Синтаксис

BOOL SHRegGetBoolUSValueA(
  [in]           LPCSTR pszSubKey,
  [in, optional] LPCSTR pszValue,
  [in]           BOOL   fIgnoreHKCU,
  [in]           BOOL   fDefault
);

Параметры

[in] pszSubKey

Тип: LPCTSTR

Указатель на строку, завершаемую null, с именем подраздела относительно HKEY_LOCAL_MACHINE и HKEY_CURRENT_USER. Например, "Software\MyCompany\MyProduct".

[in, optional] pszValue

Тип: LPCTSTR

Указатель на строку, завершающуюся значением NULL, которая указывает имя значения. Это значение может иметь значение NULL.

[in] fIgnoreHKCU

Тип: BOOL

Переменная, указывающая, под каким ключом следует искать. Если задано значение TRUE, shRegGetUSValue игнорирует HKEY_CURRENT_USER и возвращает значение из HKEY_LOCAL_MACHINE.

[in] fDefault

Тип: BOOL

Значение, возвращаемое, если значение реестра отсутствует.

Возвращаемое значение

Тип: BOOL

Возвращает значение из реестра или fDefault , если оно не найдено.

Комментарии

Примечание

Заголовок shlwapi.h определяет SHRegGetBoolUSValue в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 4.71 или более поздняя)