OpenRegStream-Funktion (shlobj_core.h)

[OpenRegStream ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen SHOpenRegStream2 oder SHOpenRegStream.]

Öffnet einen Registrierungswert und stellt eine IStream-Schnittstelle bereit, die zum Lesen oder Schreiben in den Wert verwendet werden kann.

Syntax

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

Parameter

[in] hkey

Typ: HKEY

Ein Handle für den Schlüssel, der derzeit geöffnet ist.

[in, optional] pszSubkey

Typ: PCWSTR

Eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Unterschlüssels angibt.

[in, optional] pszValue

Typ: PCWSTR

Eine Unicode-Zeichenfolge mit Null-Beendigung, die den Wert angibt, auf den zugegriffen werden soll.

grfMode

Art: DWORD

Der Zugriffstyp für den Stream. Dies kann einer der folgenden Werte sein.

STGM_READ

Öffnen Sie den Stream zum Lesen.

STGM_WRITE

Öffnen Sie den Stream zum Schreiben.

STGM_READWRITE

Öffnen Sie den Stream zum Lesen und Schreiben.

Rückgabewert

Typ: IStream*

Gibt bei erfolgreicher Ausführung die Adresse einer IStream-Schnittstelle zurück, andernfalls NULL .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (einschließlich Shlobj.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 5.0 oder höher)