SHOpenRegStreamA-Funktion (shlwapi.h)

Artikel
11/20/2024

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

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

Syntax

IStream * SHOpenRegStreamA(
  [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-oder einer Unfähigkeit zum Öffnen des Datenstroms.

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

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.

Anmerkung

Der Header "shlwapi.h" 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 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 4.71 oder höher)

Freigeben über