Auf Englisch lesen

Freigeben über


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.

Syntax

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

Parameter

[_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.

Rückgabewert

Die Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.

Bemerkungen

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.

Anforderungen

Anforderung Wert
Zielplattform- Universal
Minimale KMDF-Version 1.21
Mindest-UMDF-Version 2.33
Header- netconfiguration.h (include netadaptercx.h)
IRQL- PASSIVE_LEVEL