IRegistryKey::QueryRegistryValues-Methode (portcls.h)
Die QueryRegistryValues
-Methode ermöglicht es dem Aufrufer, mehrere Werte aus der Registrierung mit einem einzelnen Aufruf abzufragen.
Syntax
NTSTATUS QueryRegistryValues(
[in] PRTL_QUERY_REGISTRY_TABLE QueryTable,
[in, optional] PVOID Context
);
Parameter
[in] QueryTable
Zeiger auf ein Array mit mindestens einer RTL_QUERY_REGISTRY_TABLE Strukturen. (Diese Struktur wird in RtlQueryRegistryValues beschrieben.) 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 vom Aufrufer definierter Kontextwert. Die QueryRegistryValues
-Methode übergibt diesen Wert als Aufrufparameter an jeden QueryRoutine-Rückruf . Der Kontextwert ist in der Regel ein Zeiger auf eine vom Aufrufer definierte Struktur, die Kontextdaten enthält, auf die queryRoutine des Aufrufers zugreift. Der Kontextwert wird in den Zeigertyp PVOID umgewandelt, aber die QueryRegistryValues
Methode führt keine Überprüfung des Zeigers durch.
Rückgabewert
QueryRegistryValues
gibt STATUS_SUCCESS zurück, wenn der Aufruf die gesamte QueryTable erfolgreich verarbeitet hat. Andernfalls gibt die Methode einen entsprechenden Fehlercode zurück. In der folgenden Tabelle sind einige der möglichen Rückgabecodes status 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. |
Hinweise
Diese Methode verwendet vom Aufrufer bereitgestellte Rückrufroutinen, um die Werte einer Liste von Registrierungseinträgen aufzulisten. Bei erfolgreicher Ausführung gibt die Methode nach dem Aufruf aller Rückrufroutinen in der Liste zurück.
Der QueryTable-Parameter 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 | Universell |
Header | portcls.h (include Portcls.h) |
IRQL | PASSIVE_LEVEL |