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 mit Null beendete 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 mit Null beendete Zeichenfolge, die den Namen des Werts angibt. Dieser Wert kann NULL-sein.
[in] fIgnoreHKCU
Typ: BOOL-
Eine Variable, die angibt, unter welchem Schlüssel gesucht werden soll. Wenn dieser Wert auf TRUEfestgelegt ist, ignoriert SHRegGetUSValueHKEY_CURRENT_USER und gibt einen Wert aus HKEY_LOCAL_MACHINEzurü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 keine gefunden wird.
Bemerkungen
Anmerkung
Der Header "shlwapi.h" 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 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) |