Funzione SHGetValueA (shlwapi.h)
Recupera un valore del Registro di sistema.
Sintassi
LSTATUS SHGetValueA(
[in] HKEY hkey,
[in, optional] LPCSTR pszSubKey,
[in, optional] LPCSTR pszValue,
[out, optional] DWORD *pdwType,
[out, optional] void *pvData,
[in, out, optional] DWORD *pcbData
);
Parametri
[in] hkey
Tipo: HKEY
Handle per la chiave attualmente aperta o uno dei valori predefiniti seguenti.
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_USERS
[in, optional] pszSubKey
Tipo: LPCTSTR
Indirizzo di una stringa con terminazione Null che specifica il nome della sottochiave da cui recuperare il valore.
[in, optional] pszValue
Tipo: LPCTSTR
Indirizzo del valore.
[out, optional] pdwType
Tipo: LPDWORD
Tipo di valore. Per altre informazioni, vedere Tipi di dati del Registro di sistema.
[out, optional] pvData
Tipo: LPVOID
Indirizzo del buffer dei dati di destinazione.
[in, out, optional] pcbData
Tipo: LPDWORD
Dimensioni del buffer dei dati di destinazione.
Valore restituito
Tipo: LSTATUS
Restituisce ERROR_SUCCESS in caso di esito positivo oppure un codice di errore diverso da zero definito in Winerror.h in caso contrario. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per recuperare una descrizione generica dell'errore.
Commenti
Se l'applicazione deve impostare/recuperare una serie di valori nella stessa chiave, è preferibile aprire la chiave una sola volta e impostare/recuperare i valori con le normali funzioni del Registro di sistema Di Microsoft Win32 anziché usare ripetutamente questa funzione.
Nota
L'intestazione shlwapi.h definisce SHGetValue 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
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) |