Metodo IRegistryKey::QueryRegistryValues (portcls.h)
Il QueryRegistryValues metodo consente al chiamante di eseguire query su diversi valori dal Registro di sistema con una singola chiamata.
Sintassi
NTSTATUS QueryRegistryValues(
[in] PRTL_QUERY_REGISTRY_TABLE QueryTable,
[in, optional] PVOID Context
);
Parametri
[in] QueryTable
Puntatore a una matrice di una o più strutture RTL_QUERY_REGISTRY_TABLE. Questa struttura è descritta in RtlQueryRegistryValues. Ogni struttura specifica il nome del valore e il nome della sottochiave per una voce del Registro di sistema eseguita dalla query del chiamante. Ogni struttura contiene anche un puntatore della funzione a un caller fornito da QueryRoutine callback che il QueryRegistryValues metodo chiamerà con informazioni sulla voce del Registro di sistema corrispondente. La matrice deve essere terminata da una struttura con un membro Name che è NULL.
[in, optional] Context
Si tratta di un valore di contesto definito dal chiamante. Il QueryRegistryValues metodo passa questo valore come parametro di chiamata a ognuno dei callback di QueryRoutine . Il valore di contesto è in genere un puntatore a una struttura definita dal chiamante contenente i dati di contesto a cui accede QueryRoutine del chiamante. Il valore di contesto viene eseguito il cast al tipo PVOID del puntatore, ma il QueryRegistryValues metodo non esegue alcuna convalida del puntatore.
Valore restituito
QueryRegistryValues restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo nell'elaborazione dell'intera tabella query. In caso contrario, il metodo restituisce un codice di errore appropriato. La tabella seguente mostra alcuni dei possibili codici di stato restituiti.
| Codice restituito | Descrizione |
|---|---|
|
Indica che il parametro QueryTable passato al metodo non è valido. |
|
Indica che il metodo non è riuscito a trovare l'oggetto specificato in una delle voci queryTable . |
Commenti
Questo metodo usa le routine di callback fornite dal chiamante per enumerare i valori di un elenco di voci del Registro di sistema. In caso di esito positivo, il metodo viene restituito dopo aver chiamato tutte le routine di callback nell'elenco.
Il parametro QueryTable punta a una matrice di strutture RTL_QUERY_REGISTRY_TABLE. Il primo membro di questa struttura, QueryRoutine, è un puntatore di funzione a una routine di callback fornita dal chiamante. Per altre informazioni, vedere RtlQueryRegistryValues.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | portcls.h (includere Portcls.h) |
| IRQL | PASSIVE_LEVEL |