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

Статья
08/26/2023

Открывает значение реестра и предоставляет поток, который можно использовать для чтения или записи в значение. Эта функция заменяет SHOpenRegStream.

Синтаксис

IStream * SHOpenRegStream2A(
  [in]           HKEY   hkey,
  [in, optional] LPCSTR pszSubkey,
  [in, optional] LPCSTR pszValue,
  [in]           DWORD  grfMode
);

Параметры

[in] hkey

Тип: HKEY

Обязательный. Поддерево, например HKEY_LOCAL_MACHINE, содержащее значение .

[in, optional] pszSubkey

Тип: LPCTSTR

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

[in, optional] pszValue

Тип: LPCTSTR

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

[in] grfMode

Тип: DWORD

Тип доступа для потока. Может иметь одно из следующих значений:

STGM_READ

Откройте поток для чтения.

STGM_WRITE

Откройте поток для записи.

STGM_READWRITE

Откройте поток для чтения и записи.

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

Тип: IStream*

В случае успешного выполнения возвращает указатель интерфейса IStream ; в противном случае — NULL. Значение NULL может быть вызвано несколькими ситуациями, включая недопустимый ключ hkey или pszSubkey, подраздел с именем pszSubkey , который не существует, вызывающий объект без достаточных разрешений на доступ к подразделу или невозможность открыть поток.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlwapi.h
Библиотека	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя)

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