Funzione SHRegQueryInfoUSKeyA (shlwapi.h)
Recupera informazioni su una sottochiave del Registro di sistema specificata in un sottoalbero specifico dell'utente (HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE).
Sintassi
LSTATUS SHRegQueryInfoUSKeyA(
[in] HUSKEY hUSKey,
[out, optional] LPDWORD pcSubKeys,
[out, optional] LPDWORD pcchMaxSubKeyLen,
[out, optional] LPDWORD pcValues,
[out, optional] LPDWORD pcchMaxValueNameLen,
[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 e diritti di accesso delle chiavi del Registro di sistema.
Questo handle può essere ottenuto tramite la funzione SHRegOpenUSKey .
[out, optional] pcSubKeys
Tipo: LPDWORD
Puntatore a un DWORD che riceve il numero di sottochiavi nella chiave specificata.
[out, optional] pcchMaxSubKeyLen
Tipo: LPDWORD
Puntatore a un DWORD che riceve il numero di caratteri nel nome della sottochiave più grande.
[out, optional] pcValues
Tipo: LPDWORD
Puntatore a un DWORD che riceve il numero di valori nella chiave specificata.
[out, optional] pcchMaxValueNameLen
Tipo: LPDWORD
Puntatore a un DWORD che riceve il numero di caratteri nel nome di valore più grande.
[in] enumRegFlags
Tipo: SHREGENUM_FLAGS
Una delle SHREGENUM_FLAGS che specifica la chiave di base in cui deve essere eseguita la query.
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 SHRegQueryInfoUSKey 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) |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per