Функция 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 .

Комментарии

Требования