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

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

  • Статья

[Эта функция больше не поддерживается.]

Получает указанные сведения из реестра. Эта функция будет проверка HKEY_CURRENT_USER запрашиваемых сведений в указанном подразделе. Если данные не существуют в поддереве HKEY_CURRENT_USER, функция проверяет HKEY_LOCAL_MACHINE поддереве на наличие той же информации.

Синтаксис

LSTATUS SHRegGetValueFromHKCUHKLM(
  [in]      PCWSTR pwszKey,
  [in]      PCWSTR pwszValue,
  [in]      SRRF   srrfFlags,
  [out]     DWORD  *pdwType,
  [in]      void   *pvData,
  [in, out] DWORD  *pcbData
);

Параметры

[in] pwszKey

Тип: PCWSTR

Указатель на строку Юникода, завершающуюся null, которая указывает путь к разделу реестра.

[in] pwszValue

Тип: PCWSTR

Указатель на строку Юникода, завершающуюся null, которая указывает значение ключа. Это значение может иметь значение NULL, и в этом случае данные извлекаются из значения по умолчанию.

[in] srrfFlags

Тип: SRRF

Константы флага SRRF . Если используется несколько флагов, их можно объединить с помощью побитового ИЛИ. Эти флаги используются для ограничения типа возвращаемых данных. Это значение не может быть равно 0.

[out] pdwType

Тип: DWORD*

При возврате этой функции содержит указатель на DWORD , который получает код, указывающий тип данных, хранящихся в указанном значении. Для этого параметра можно задать значение NULL , если информация о типе не требуется. Если это значение не равно NULL и флаг SRRF_NOEXPAND не задан, типы данных REG_EXPAND_SZ будут возвращены как REG_SZ, так как они автоматически расширяются в этом методе.

[in] pvData

Тип: LPCVOID

Указатель на буфер, содержащий данные значения. Этот параметр может иметь значение NULL , если данные не требуются. Это значение должно содержать размер буфера pvData в записи. Если pvData имеет значение NULL (или если pvData не равно NULL, но слишком мало буфера для хранения данных реестра), то при выходе он будет содержать размер, необходимый для хранения данных реестра.

[in, out] pcbData

Тип: DWORD*

При возврате этой функции содержит указатель на размер данных в байтах.

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

Тип: LONG

В случае успешного выполнения эта функция возвращает ERROR_SUCCESS и все запрошенные параметры. Возвращает ERROR_MORE_DATA, если функция завершается сбоем из-за нехватки места в предоставленном pvData, отличном от NULL . В этом случае допустимые данные могут содержать только pdwType и pcbData , pvData будет неопределенным. В противном случае возвращает ненулевой код ошибки, определенный в Winerror.h . Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
DLL Shlwapi.dll