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.

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.

Requisiti

Vedi anche

Funzioni del Registro di sistema

Panoramica del Registro di sistema

VALENT