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

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

  • Статья

Открывает раздел реестра и запрашивает его для определенного значения.

Синтаксис

LSTATUS SHQueryValueExW(
  [in]                HKEY    hkey,
  [in, optional]      LPCWSTR pszValue,
                      DWORD   *pdwReserved,
  [out, optional]     DWORD   *pdwType,
  [out, optional]     void    *pvData,
  [in, out, optional] DWORD   *pcbData
);

Параметры

[in] hkey

Тип: HKEY

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

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in, optional] pszValue

Тип: LPCTSTR

Адрес строки null-terminated, содержащей имя запрашиваемого значения.

pdwReserved

Тип: LPDWORD

Скрытный. Должен быть null.

[out, optional] pdwType

Тип: LPDWORD

Адрес переменной, получающей тип значения ключа. Дополнительные сведения см. в типах данных реестра.

[out, optional] pvData

Тип: LPVOID

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

[in, out, optional] pcbData

Тип: LPDWORD

Адрес переменной, указывающей размер буфера в байтах, на который указывает параметр pvData. Когда функция возвращается, эта переменная содержит размер скопированных данных в pvData.

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

Тип: DWORD

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

Замечания

Заметка

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

Требования

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