Funzione SHEnumKeyExA (shlwapi.h)

Enumera le sottochiavi della chiave del Registro di sistema aperta specificata.

Sintassi

LSTATUS SHEnumKeyExA(
  [in] HKEY    hkey,
       DWORD   dwIndex,
       LPSTR   pszName,
  [in] LPDWORD pcchName
);

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

dwIndex

Tipo: DWORD

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

pszName

Tipo: LPTSTR

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

[in] pcchName

Tipo: LPDWORD

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

Valore restituito

Tipo: LSTATUS

Restituisce ERROR_SUCCESS in caso di esito positivo oppure 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 SHEnumKeyEx 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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)