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

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

  • Статья

Перечисляет значения указанного открытого раздела реестра.

Синтаксис

LSTATUS SHEnumValueW(
  [in]                HKEY    hkey,
  [in]                DWORD   dwIndex,
                      PWSTR   pszValueName,
  [in, out, optional] LPDWORD pcchValueName,
  [out, optional]     LPDWORD pdwType,
                      void    *pvData,
  [in, out, optional] LPDWORD pcbData
);

Параметры

[in] hkey

Тип: HKEY

Дескриптор открытого ключа или любого из следующих предопределенных значений.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in] dwIndex

Тип: DWORD

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

pszValueName

Тип: LPTSTR

Адрес буфера символов, получающего имя перечисленного значения. Размер этого буфера указывается в pcchValueName.

[in, out, optional] pcchValueName

Тип: LPDWORD

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

[out, optional] pdwType

Тип: LPDWORD

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

pvData

Тип: LPVOID

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

[in, out, optional] pcbData

Тип: LPDWORD

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

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

Тип: LSTATUS

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

Замечания

Заметка

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

Требования

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