Condividi tramite

Funzione SHRegEnumUSValueA (shlwapi.h)

  • Articolo

Enumera i valori della sottochiave del Registro di sistema specificata in un sottoalbero specifico dell'utente (HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE).

Sintassi

LSTATUS SHRegEnumUSValueA(
  [in]                HUSKEY          hUSkey,
  [in]                DWORD           dwIndex,
  [out]               LPSTR           pszValueName,
  [in, out]           LPDWORD         pcchValueName,
  [out, optional]     LPDWORD         pdwType,
  [out, optional]     void            *pvData,
  [in, out, optional] LPDWORD         pcbData,
  [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 del valore da recuperare. Questo parametro deve essere zero per la prima chiamata e incrementato per le chiamate successive.

[out] pszValueName

Tipo: LPTSTR

Puntatore a un buffer di caratteri che riceve il nome del valore enumerato. Le dimensioni di questo buffer vengono specificate in pcchValueNameLen.

[in, out] pcchValueName

Tipo: LPDWORD

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

[out, optional] pdwType

Tipo: LPDWORD

Puntatore a un DWORD che riceve il tipo di dati del valore. Si tratta degli stessi valori descritti nel parametro lpType di RegEnumValue.

[out, optional] pvData

Tipo: void*

Puntatore a un buffer che riceve i dati per la voce di valore. Le dimensioni di questo buffer vengono specificate in pcbData. Questo parametro può essere null se i dati non sono necessari.

[in, out, optional] pcbData

Tipo: LPDWORD

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

[in] enumRegFlags

Tipo: SHREGENUM_FLAGS

Una delle 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

Nota

L'intestazione shlwapi.h definisce SHRegEnumUSValue 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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 Finestre
intestazione shlwapi.h
libreria Shlwapi.lib
dll Shlwapi.dll (versione 4.71 o successiva)