Funzione SHEnumValueA (shlwapi.h)

Enumera i valori della chiave del Registro di sistema aperta specificata.

Sintassi

LSTATUS SHEnumValueA(
  [in]                HKEY    hkey,
  [in]                DWORD   dwIndex,
                      PSTR    pszValueName,
  [in, out, optional] LPDWORD pcchValueName,
  [out, optional]     LPDWORD pdwType,
                      void    *pvData,
  [in, out, optional] LPDWORD pcbData
);

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

[in] dwIndex

Tipo: DWORD

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

pszValueName

Tipo: LPTSTR

Indirizzo di un buffer di caratteri che riceve il nome del valore enumerato. Le dimensioni di questo buffer vengono specificate in pcchValueName.

[in, out, optional] pcchValueName

Tipo: LPDWORD

L'indirizzo di 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

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

pvData

Tipo: LPVOID

Indirizzo di 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

L'indirizzo di un DWORD che, in ingresso, contiene le dimensioni del buffer in pvData, in byte. All'uscita, contiene il numero di byte copiati in pvData.

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