NetConfigurationQueryBinary-Funktion (netconfiguration.h)

Artikel
05/23/2024

Ruft die Daten ab, die derzeit einem angegebenen Registrierungswert zugewiesen sind, speichert die Daten in einem vom Framework zugewiesenen Puffer und erstellt ein Frameworkspeicherobjekt zur Darstellung des Puffers.

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 für ein 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 typisierter Wert, der den Typ des Arbeitsspeichers 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_ATTRIBUTES werden.

[_Out_] Memory

Ein Zeiger auf eine Position, die ein Handle auf 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 entsprechenden NTSTATUS-Fehlercode zurück.

Hinweise

Der Clienttreiber ruft ein Handle für ein NETCONFIGURATION-Objekt ab, indem er NetConfigurationOpenConfiguration oder NetConfigurationOpenSubConfiguration aufruft.

Der von dieser Funktion zugewiesene Arbeitsspeicher wird automatisch vom Framework freigegeben, wenn das NETCONFIGURATION-Objekt geschlossen wird.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.21
UMDF-Mindestversion	2.33
Kopfzeile	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Freigeben über