Funzione SHRegQueryInfoUSKeyA (shlwapi.h)

Recupera informazioni su una sottochiave del Registro di sistema specificata in un sottoalbero specifico dell'utente (HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE).

Sintassi

LSTATUS SHRegQueryInfoUSKeyA(
  [in]            HUSKEY          hUSKey,
  [out, optional] LPDWORD         pcSubKeys,
  [out, optional] LPDWORD         pcchMaxSubKeyLen,
  [out, optional] LPDWORD         pcValues,
  [out, optional] LPDWORD         pcchMaxValueNameLen,
  [in]            SHREGENUM_FLAGS enumRegFlags
);

Parametri

[in] hUSKey

Tipo: HUSKEY

Handle per una sottochiave del Registro di sistema attualmente aperta. La sottochiave deve essere stata aperta con il diritto di accesso KEY_SET_VALUE. Per altre informazioni, vedere sicurezza delle chiavi del Registro di sistema e diritti di accesso.

Questo handle può essere ottenuto tramite la funzione SHRegOpenUSKey .

[out, optional] pcSubKeys

Tipo: LPDWORD

Puntatore a un DWORD che riceve il numero di sottochiavi nella chiave specificata.

[out, optional] pcchMaxSubKeyLen

Tipo: LPDWORD

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

[out, optional] pcValues

Tipo: LPDWORD

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

[out, optional] pcchMaxValueNameLen

Tipo: LPDWORD

Puntatore a un DWORD che riceve il numero di caratteri nel nome di valore più grande.

[in] enumRegFlags

Tipo: SHREGENUM_FLAGS

Una delle SHREGENUM_FLAGS che specifica la chiave di base in cui deve essere eseguita la query.

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 testuale dell'errore.

Osservazioni

Fabbisogno