SHOpenRegStream2W-Funktion (shlwapi.h)

Artikel
08/26/2023

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

Syntax

IStream * SHOpenRegStream2W(
  [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-endende 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-endende 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, darunter ein ungültiger hkey oder pszSubkey, ein nicht vorhandener Unterschlüssel namens pszSubkey , ein Aufrufer ohne ausreichende Berechtigungen für den Zugriff auf den Unterschlüssel oder eine Unfähigkeit, den Stream zu öffnen.

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 SHOpenRegStream2 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 Code, der nicht Codierungsneutral ist, 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 5.0 oder höher)

Share via