Freigeben über


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)