SHOpenRegStreamW-Funktion (shlwapi.h)

Veraltet. Öffnet einen Registrierungswert und stellt einen Stream bereit, der zum Lesen oder Schreiben in den Wert verwendet werden kann.

Hinweis Diese Funktion wurde durch SHOpenRegStream2 ersetzt. Es wird empfohlen, SHOpenRegStream2 jederzeit zu verwenden.

 

Syntax

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

Parameter

[in] hkey

Typ: HKEY

Erforderlich. Die Unterstruktur, z. B. HKEY_LOCAL_MACHINE, die den Wert enthält.

[in, optional] pszSubkey

Typ: LPCTSTR

Optional. Zeiger auf eine NULL-Zeichenfolge, die den Unterschlüssel angibt, der den Wert enthält. Dieser Wert kann NULL sein.

[in, optional] pszValue

Typ: LPCTSTR

Zeiger auf eine NULL-Zeichenfolge, die den Wert angibt, auf den zugegriffen werden soll. Dieser Wert kann NULL sein.

[in] grfMode

Art: DWORD

Der Zugriffstyp für den Stream. Mögliche Werte:

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 einen IStream-Schnittstellenzeiger zurück. andernfalls NULL. Ein NULL-Wert kann durch mehrere Situationen verursacht werden, z. B. durch einen ungültigen hkey oder pszSubkey oder durch eine Unfähigkeit, den Stream zu öffnen.

Hinweis In einigen Situationen, z. B. wenn der von pszSubkey benannte Unterschlüssel nicht vorhanden ist oder der Aufrufer nicht über ausreichende Berechtigungen für den Zugriff auf den Unterschlüssel verfügt, wird anstelle eines NULL-Werts ein Stream der Länge null zurückgegeben. SHOpenRegStream2 gibt null in allen Fehlersituationen zurück und ist aus diesem Grund die bevorzugte Funktion.

 

Hinweise

Die aufrufende Anwendung ist dafür verantwortlich, die Release-Methode des zurückgegebenen Objekts aufzurufen, wenn dieses IStream-Objekt nicht mehr benötigt wird.

Hinweis

Der shlwapi.h-Header definiert SHOpenRegStream als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 4.71 oder höher)