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

Статья
08/26/2023

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

Примечание Эта функция заменена shOpenRegStream2. Рекомендуется всегда использовать SHOpenRegStream2 .

Синтаксис

IStream * SHOpenRegStreamA(
  [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.

[in, optional] pszValue

Тип: LPCTSTR

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

[in] grfMode

Тип: DWORD

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

STGM_READ

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

STGM_WRITE

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

STGM_READWRITE

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

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

Тип: IStream*

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

Примечание В некоторых ситуациях, например когда подраздел с именем pszSubkey не существует или вызывающий объект не имеет достаточных разрешений для доступа к подразделу, возвращается поток нулевой длины, а не значение NULL . SHOpenRegStream2 возвращает значение NULL во всех ситуациях ошибок и является предпочтительной функцией по этой причине.

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

Требования

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

Share via