NetConfigurationQueryBinary-Funktion (netconfiguration.h)
Ruft die Daten ab, die derzeit einem angegebenen Registrierungswert zugewiesen sind, speichert die Daten in einem vom Framework zugewiesenen Puffer und erstellt ein Frameworkspeicherobjekt, das den Puffer darstellt.
NTSTATUS NetConfigurationQueryBinary(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING ValueName,
[_In_] POOL_TYPE PoolType,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
[_Out_] WDFMEMORY *Memory
);
[_In_] Configuration
Ein Handle zu einem NETCONFIGURATION -Objekt, das einen geöffneten Registrierungsschlüssel darstellt.
[_In_] ValueName
Ein Zeiger auf eine UNICODE_STRING Struktur, die einen Wertnamen enthält.
[_In_] PoolType
Ein POOL_TYPE-typed-Wert, der den Speichertyp angibt, der für den Datenpuffer zugewiesen werden soll.
[_In_opt_] MemoryAttributes
Ein Zeiger auf eine WDF_OBJECT_ATTRIBUTES Struktur, die Objektattribute für das neue Speicherobjekt enthält. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTESwerden.
[_Out_] Memory
Ein Zeiger auf eine Position, die ein Handle für das neue Speicherobjekt empfängt. Das Framework weist diesen Speicherpuffer zu und gibt ihn automatisch frei, wenn das NETCONFIGURATION-Objekt geschlossen wird.
Die Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.
Der Clienttreiber ruft ein Handle für ein NETCONFIGURATION -Objekt ab, indem NetAdapterOpenConfiguration oder NetConfigurationOpenSubConfigurationaufgerufen wird.
Der von dieser Funktion zugewiesene Arbeitsspeicher wird automatisch vom Framework freigegeben, wenn das NETCONFIGURATION-Objekt geschlossen wird.
Anforderung | Wert |
---|---|
Zielplattform- | Universal |
Minimale KMDF-Version | 1.21 |
Mindest-UMDF-Version | 2.33 |
Header- | netconfiguration.h (include netadaptercx.h) |
IRQL- | PASSIVE_LEVEL |