Funzione RegQueryMultipleValuesA (winreg.h)
Recupera il tipo e i dati per un elenco di nomi di valori associati a una chiave del Registro di sistema aperta.
Sintassi
LSTATUS RegQueryMultipleValuesA(
[in] HKEY hKey,
[out] PVALENTA val_list,
[in] DWORD num_vals,
[out, optional] LPSTR lpValueBuf,
[in, out, optional] LPDWORD ldwTotsize
);
Parametri
[in] hKey
Handle per una chiave del Registro di sistema aperta. La chiave deve essere stata aperta con il diritto di accesso KEY_QUERY_VALUE. Per ulteriori informazioni, vedere
Sicurezza e diritti di accesso delle chiavi del Registro di sistema.
Questo handle viene restituito dalla funzione RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx o RegOpenKeyTransacted. Può anche essere una delle chiavi predefinite seguenti:
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_PERFORMANCE_DATA
- HKEY_USERS
[out] val_list
Puntatore a una matrice di
Strutture VALENT che descrivono una o più voci di valore. In input, il membro ve_valuename di ogni struttura deve contenere un puntatore al nome di un valore da recuperare. La funzione ha esito negativo se uno dei valori specificati non esiste nella chiave specificata.
Se la funzione ha esito positivo, ogni elemento della matrice contiene le informazioni per il valore specificato.
[in] num_vals
Numero di elementi nella matrice di val_list .
[out, optional] lpValueBuf
Puntatore a un buffer. Se la funzione ha esito positivo, il buffer riceve i dati per ogni valore.
Se lpValueBuf è NULL, il valore a cui punta il parametro ldwTotsize deve essere zero, nel qual caso la funzione restituisce ERROR_MORE_DATA e ldwTotsize riceve le dimensioni necessarie del buffer, in byte.
[in, out, optional] ldwTotsize
Puntatore a una variabile che specifica le dimensioni del buffer a cui punta il parametro lpValueBuf , in byte. Se la funzione ha esito positivo, ldwTotsize riceve il numero di byte copiati nel buffer. Se la funzione ha esito negativo perché il buffer è troppo piccolo, ldwTotsize riceve le dimensioni necessarie, in byte.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
RegQueryMultipleValues non può creare o accedere al provider della chiave dinamica. |
|
Il buffer a cui punta lpValueBuf era troppo piccolo. In questo caso, ldwTotsize riceve le dimensioni del buffer necessarie. |
|
La dimensione totale dei dati richiesti (dimensioni della matrice val_list + ldwTotSize) è maggiore del limite di sistema di un megabyte. |
Commenti
La funzione RegQueryMultipleValues consente a un'applicazione di eseguire query su uno o più valori di una chiave statica o dinamica. Se la chiave di destinazione è una chiave statica, il sistema fornisce tutti i valori in modo atomico. Per evitare una serializzazione eccessiva, i dati aggregati restituiti dalla funzione non possono superare un megabyte.
Se la chiave di destinazione è una chiave dinamica, il provider deve fornire tutti i valori in modo atomico. Ciò significa che il provider deve riempire il buffer dei risultati in modo sincrono, fornendo una visualizzazione coerente di tutti i valori nel buffer, evitando l'eccessiva serializzazione. Il provider può fornire al massimo un megabyte di dati di output totali durante una chiamata atomica a questa funzione.
RegQueryMultipleValues è supportato in remoto; ovvero, il parametro hKey passato alla funzione può fare riferimento a un computer remoto.
Nota
L'intestazione winreg.h definisce RegQueryMultipleValues 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
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winreg.h (include Windows.h) |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |
Vedi anche
Funzioni del Registro di sistema