Condividi tramite

Funzione SHQueryValueExA (shlwapi.h)

  • Articolo

Apre una chiave del Registro di sistema e la esegue una query per un valore specifico.

Sintassi

LSTATUS SHQueryValueExA(
  [in]                HKEY   hkey,
  [in, optional]      LPCSTR pszValue,
                      DWORD  *pdwReserved,
  [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] pszValue

Tipo: LPCTSTR

Indirizzo della stringa con terminazione Null contenente il nome del valore su cui eseguire una query.

pdwReserved

Tipo: LPDWORD

Riservato. Deve essere NULL.

[out, optional] pdwType

Tipo: LPDWORD

Indirizzo della variabile che riceve il tipo di valore della chiave. Per altre informazioni, vedere Tipi di dati del Registro di sistema.

[out, optional] pvData

Tipo: LPVOID

Indirizzo del buffer che riceve i dati del valore. Questo parametro può essere NULL se i dati non sono necessari.

[in, out, optional] pcbData

Tipo: LPDWORD

Indirizzo della variabile che specifica le dimensioni, in byte, del buffer a cui punta il parametro pvData . Al termine della funzione, questa variabile contiene le dimensioni dei dati copiati in pvData.

Valore restituito

Tipo: DWORD

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

Nota

L'intestazione shlwapi.h definisce SHQueryValueEx 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

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)