Funzione SHQueryInfoKeyA (shlwapi.h)

Recupera informazioni su una chiave del Registro di sistema specificata.

Sintassi

LSTATUS SHQueryInfoKeyA(
  [in]            HKEY    hkey,
  [out, optional] LPDWORD pcSubKeys,
  [out, optional] LPDWORD pcchMaxSubKeyLen,
  [out, optional] LPDWORD pcValues,
  [out, optional] LPDWORD pcchMaxValueNameLen
);

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

[out, optional] pcSubKeys

Tipo: LPDWORD

Indirizzo di un DWORD che riceve il numero di sottochiave nella chiave specificata.

[out, optional] pcchMaxSubKeyLen

Tipo: LPDWORD

Indirizzo di un DWORD che riceve il numero di caratteri nel nome della sottochiave con il nome più grande.

[out, optional] pcValues

Tipo: LPDWORD

Indirizzo di un DWORD che riceve il numero di valori nella chiave specificata.

[out, optional] pcchMaxValueNameLen

Tipo: LPDWORD

Indirizzo di un DWORD che riceve il numero di caratteri nel nome del valore con il nome più grande.

Valore restituito

Tipo: LSTATUS

Restituisce ERROR_SUCCESS se ha 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 testuale dell'errore.

Commenti

Nota

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

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)