SHRegGetBoolUSValueW-Funktion (shlwapi.h)

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

Syntax

BOOL SHRegGetBoolUSValueW(
  [in]           LPCWSTR pszSubKey,
  [in, optional] LPCWSTR pszValue,
  [in]           BOOL    fIgnoreHKCU,
  [in]           BOOL    fDefault
);

Parameter

[in] pszSubKey

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende 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-endende 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. Bei Festlegung auf TRUE ignoriert SHRegGetUSValueHKEY_CURRENT_USER und gibt einen Wert aus 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 wird.

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 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 4.71 oder höher)