IRegistryKey::QueryRegistryValues-Methode (portcls.h)
Mit der QueryRegistryValues-Methode kann der Aufrufer mehrere Werte aus der Registrierung mit einem einzelnen Aufruf abfragen.
Syntax
NTSTATUS QueryRegistryValues(
[in] PRTL_QUERY_REGISTRY_TABLE QueryTable,
[in, optional] PVOID Context
);
Parameter
[in] QueryTable
Zeigen Sie auf ein Array mit mindestens einem RTL_QUERY_REGISTRY_TABLE Strukturen. (Diese Struktur wird in RtlQueryRegistryValuesbeschrieben.) Jede Struktur gibt den Wertnamen und den Unterschlüsselnamen für einen Registrierungseintrag an, den der Aufrufer abfragt. Jede Struktur enthält auch einen Funktionszeiger auf einen vom Aufrufer bereitgestellten QueryRoutine- Rückruf, den die QueryRegistryValues-Methode mit Informationen zum entsprechenden Registrierungseintrag aufruft. Das Array muss durch eine Struktur mit einem Name Member beendet werden, das NULL-ist.
[in, optional] Context
Dies ist ein aufruferdefinierter Kontextwert. Die QueryRegistryValues-Methode übergibt diesen Wert als Aufrufparameter an jeden der QueryRoutine- Rückrufe. Der Kontextwert ist in der Regel ein Zeiger auf eine benutzerdefinierte Struktur, die Kontextdaten enthält, auf die die QueryRoutine des Aufrufers zugreift. Der Kontextwert wird in den Zeigertyp PVOID umgegossen, die QueryRegistryValues-Methode führt jedoch keine Überprüfung des Zeigers durch.
Rückgabewert
QueryRegistryValues gibt STATUS_SUCCESS zurück, wenn der Aufruf bei der Verarbeitung der gesamten QueryTable-erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück. In der folgenden Tabelle sind einige der möglichen Rückgabestatuscodes aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Gibt an, dass der QueryTable Parameter, der an die Methode übergeben wurde, ungültig ist. |
|
Gibt an, dass die Methode das Objekt nicht finden konnte, das in einem der QueryTable- Einträge angegeben wurde. |
Bemerkungen
Diese Methode verwendet vom Aufrufer bereitgestellte Rückrufroutinen zum Aufzählen der Werte einer Liste von Registrierungseinträgen. Bei erfolgreicher Ausführung gibt die Methode nach dem Aufrufen aller Rückrufroutinen in der Liste zurück.
Der parameter QueryTable verweist auf ein Array von RTL_QUERY_REGISTRY_TABLE Strukturen. Das erste Element dieser Struktur, QueryRoutine, ist ein Funktionszeiger auf eine vom Aufrufer bereitgestellte Rückrufroutine. Weitere Informationen finden Sie unter RtlQueryRegistryValues.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | portcls.h (include Portcls.h) |
| IRQL- | PASSIVE_LEVEL |