Funzione SHRegEnumUSKeyA (shlwapi.h)

Enumera le sottochiavi di una sottochiave del Registro di sistema in un sottoalbero specifico dell'utente (HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE).

Sintassi

LSTATUS SHRegEnumUSKeyA(
  [in]      HUSKEY          hUSKey,
  [in]      DWORD           dwIndex,
  [out]     LPSTR           pszName,
  [in, out] LPDWORD         pcchName,
  [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 .

[in] dwIndex

Tipo: DWORD

Indice della sottochiave da recuperare. Questo parametro deve essere zero per la prima chiamata e incrementato per le chiamate successive.

[out] pszName

Tipo: LPTSTR

Puntatore a un buffer di caratteri che riceve il nome della chiave enumerata.

[in, out] pcchName

Tipo: LPDWORD

Puntatore a un DWORD che, nella voce, contiene le dimensioni del buffer in corrispondenza di pszName, in caratteri . All'uscita, contiene il numero di caratteri copiati in pszName.

[in] enumRegFlags

Tipo: SHREGENUM_FLAGS

Oggetto SHREGENUM_FLAGS che specifica la chiave di base in cui deve essere eseguita l'enumerazione.

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