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 una DWORD che, nella voce, contiene le dimensioni del buffer in pszValueName, in caratteri. In uscita, questo 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. Questi sono gli stessi valori descritti nel parametro lpType di RegEnumValue.

[out, optional] pvData

Tipo: void*

Puntatore a un buffer che riceve i dati per la voce del 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 una DWORD che, nella voce, contiene le dimensioni del buffer in pvData. In uscita, questo contiene il numero di byte copiati in pvData.

[in] enumRegFlags

Tipo: SHREGENUM_FLAGS

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

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 SHRegEnumUSValue 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

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)