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

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

  • Статья

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

Синтаксис

LSTATUS SHRegEnumUSValueA(
  [in]                HUSKEY          hUSkey,
  [in]                DWORD           dwIndex,
  [out]               LPSTR           pszValueName,
  [in, out]           LPDWORD         pcchValueName,
  [out, optional]     LPDWORD         pdwType,
  [out, optional]     void            *pvData,
  [in, out, optional] LPDWORD         pcbData,
  [in]                SHREGENUM_FLAGS enumRegFlags
);

Параметры

[in] hUSkey

Тип: HUSKEY

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

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

[in] dwIndex

Тип: DWORD

Индекс извлекаемого значения. Этот параметр должен быть равен нулю для первого вызова и увеличивается для последующих вызовов.

[out] pszValueName

Тип: LPTSTR

Указатель на буфер символов, получающий имя перечисленного значения. Размер этого буфера указывается в pcchValueNameLen.

[in, out] pcchValueName

Тип: LPDWORD

Указатель на DWORD, содержащий размер буфера в pszValueNameв символах. При выходе это содержит количество символов, скопированных в pszValueName.

[out, optional] pdwType

Тип: LPDWORD

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

[out, optional] pvData

Тип: void*

Указатель на буфер, получающий данные для записи значения. Размер этого буфера указывается в pcbData. Этот параметр может быть значение NULL, если данные не требуются.

[in, out, optional] pcbData

Тип: LPDWORD

Указатель на DWORD, содержащий размер буфера в pvData. При выходе это содержит количество байтов, скопированных в pvData.

[in] enumRegFlags

Тип: SHREGENUM_FLAGS

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

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

Тип: LSTATUS

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

Замечания

Заметка

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

Требования

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