SHOpenRegStream2A-Funktion (shlwapi.h)
Ö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 * 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
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) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für