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

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

  • Статья

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

Синтаксис

LSTATUS SHRegQueryInfoUSKeyA(
  [in]            HUSKEY          hUSKey,
  [out, optional] LPDWORD         pcSubKeys,
  [out, optional] LPDWORD         pcchMaxSubKeyLen,
  [out, optional] LPDWORD         pcValues,
  [out, optional] LPDWORD         pcchMaxValueNameLen,
  [in]            SHREGENUM_FLAGS enumRegFlags
);

Параметры

[in] hUSKey

Тип: HUSKEY

Дескриптор открытого подраздела реестра. Вложенный ключ должен быть открыт с помощью права доступа KEY_SET_VALUE. Дополнительные сведения см. в разделе "Безопасность и права доступа реестра".

Этот дескриптор можно получить с помощью функции SHRegOpenUSKey.

[out, optional] pcSubKeys

Тип: LPDWORD

Указатель на DWORD, получающий количество вложенных ключей под ключом.

[out, optional] pcchMaxSubKeyLen

Тип: LPDWORD

Указатель на DWORD, получающий количество символов в самом большом имени подраздела.

[out, optional] pcValues

Тип: LPDWORD

Указатель на DWORD, получающий количество значений под указанным ключом.

[out, optional] pcchMaxValueNameLen

Тип: LPDWORD

Указатель на DWORD, получающий количество символов в самом большом имени значения.

[in] enumRegFlags

Тип: SHREGENUM_FLAGS

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

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

Тип: LSTATUS

Возвращает ERROR_SUCCESS в случае успешного выполнения или ненулевого кода ошибки, определенного в Winerror.h в противном случае. Для получения текстового описания ошибки можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.

Замечания

Заметка

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка shlwapi.h
библиотеки Shlwapi.lib
DLL Shlwapi.dll (версия 4.71 или более поздняя)