Funzione SHRegGetBoolUSValueA (shlwapi.h)

Recupera un valore booleano da una sottochiave del Registro di sistema in un sottoalbero specifico dell'utente (HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE).

Sintassi

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

Parametri

[in] pszSubKey

Tipo: LPCTSTR

Puntatore a una stringa con terminazione null con il nome della sottochiave relativa a HKEY_LOCAL_MACHINE e HKEY_CURRENT_USER. Ad esempio, "Software\MyCompany\MyProduct".

[in, optional] pszValue

Tipo: LPCTSTR

Puntatore a una stringa con terminazione null che specifica il nome del valore. Questo valore può essere NULL.

[in] fIgnoreHKCU

Tipo: BOOL

Variabile che specifica la chiave da cercare. Se impostato su TRUE, SHRegGetUSValue ignora HKEY_CURRENT_USER e restituisce un valore da HKEY_LOCAL_MACHINE.

[in] fDefault

Tipo: BOOL

Valore restituito se non esiste alcun valore del Registro di sistema.

Valore restituito

Tipo: BOOL

Restituisce il valore dal Registro di sistema o fDefault se non viene trovato alcun elemento.

Commenti

Nota

L'intestazione shlwapi.h definisce SHRegGetBoolUSValue come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)