SHOpenRegStream2A-Funktion (shlwapi.h)

Artikel
20.11.2024

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

Syntax

C++

IStream * SHOpenRegStream2A(
  [in]           HKEY   hkey,
  [in, optional] LPCSTR pszSubkey,
  [in, optional] LPCSTR 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-

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

[in, optional] pszValue

Typ: LPCTSTR-

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den zugegriffenen Wert angibt. Dieser Wert kann NULL-sein.

[in] grfMode

Typ: DWORD-

Der Typ des Zugriffs für den Datenstrom. Dies kann einer der folgenden Werte sein:

STGM_READ

Öffnen Sie den Datenstrom zum Lesen.

STGM_WRITE

Öffnen Sie den Datenstrom zum Schreiben.

STGM_READWRITE

Öffnen Sie den Datenstrom zum Lesen und Schreiben.

Rückgabewert

Typ: IStream-*

Gibt einen IStream- Schnittstellenzeiger zurück, wenn dies erfolgreich ist; andernfalls NULL-. Ein NULL--Wert kann durch mehrere Situationen verursacht werden, einschließlich eines ungültigen hkey oder pszSubkey, einem Unterschlüssel mit dem Namen pszSubkey, der nicht vorhanden ist, einem Aufrufer ohne ausreichende Berechtigungen für den Zugriff auf den Unterschlüssel oder eine Unfähigkeit zum Öffnen des Datenstroms.

Bemerkungen

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 Header "shlwapi.h" 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Teilen über