SHRegGetBoolUSValueA-Funktion (shlwapi.h)

Ruft einen booleschen Wert aus einem Registrierungsunterschlüssel in einer benutzerspezifischen Unterstruktur (HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE) ab.

Syntax

BOOL SHRegGetBoolUSValueA(
  [in]           LPCSTR pszSubKey,
  [in, optional] LPCSTR pszValue,
  [in]           BOOL   fIgnoreHKCU,
  [in]           BOOL   fDefault
);

Parameter

[in] pszSubKey

Typ: LPCTSTR

Ein Zeiger auf eine NULL-Zeichenfolge mit dem Namen des Unterschlüssels relativ zu HKEY_LOCAL_MACHINE und HKEY_CURRENT_USER. Beispiel: "Software\MyCompany\MyProduct".

[in, optional] pszValue

Typ: LPCTSTR

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen des Werts angibt. Dieser Wert kann NULL sein.

[in] fIgnoreHKCU

Typ: BOOL

Eine Variable, die angibt, unter welchen Schlüssel gesucht werden soll. Bei Festlegung auf TRUE ignoriert SHRegGetUSValueHKEY_CURRENT_USER und gibt einen Wert von HKEY_LOCAL_MACHINE zurück.

[in] fDefault

Typ: BOOL

Ein Wert, der zurückgegeben wird, wenn kein Registrierungswert vorhanden ist.

Rückgabewert

Typ: BOOL

Gibt entweder den Wert aus der Registrierung oder fDefault zurück, wenn keiner gefunden wurde.

Hinweise

Hinweis

Der shlwapi.h-Header definiert SHRegGetBoolUSValue 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)