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

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

  • Статья

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

Синтаксис

BOOL SHRegGetBoolUSValueW(
  [in]           LPCWSTR pszSubKey,
  [in, optional] LPCWSTR 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 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка shlwapi.h
библиотеки Shlwapi.lib
DLL Shlwapi.dll (версия 4.71 или более поздняя)