Condividi tramite

Funzione SHRegGetBoolUSValueA (shlwapi.h)

  • Articolo

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 rispetto 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 esaminare. 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 è presente alcun valore del Registro di sistema.

Valore restituito

Tipo: bool

Restituisce il valore dal Registro di sistema oppure fDefault se non viene trovato alcuno.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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 Finestre
intestazione shlwapi.h
libreria Shlwapi.lib
dll Shlwapi.dll (versione 4.71 o successiva)