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 o 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.

Osservazioni

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.

Fabbisogno