NetConfigurationQueryUlong-Funktion (netconfiguration.h)

Artikel
05/23/2024

Ruft die angegebenen Daten ohne Vorzeichen (long word, REG_DWORD) aus dem Adapterkonfigurationsobjekt ab und kopiert die Daten an einen angegebenen Speicherort.

Syntax

NTSTATUS NetConfigurationQueryUlong(
  [_In_]  NETCONFIGURATION                    Configuration,
  [_In_]  NET_CONFIGURATION_QUERY_ULONG_FLAGS Flags,
  [_In_]  PCUNICODE_STRING                    ValueName,
  [_Out_] ULONG                               *Value
);

Parameter

[_In_] Configuration

Handle für ein NETCONFIGURATION-Objekt, das einen geöffneten Registrierungsschlüssel darstellt.

[_In_] Flags

Ein gültiges bitweises OR mit NET_CONFIGURATION_QUERY_ULONG_FLAGS typisierten Flags.

[_In_] ValueName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die einen Namen für den ULONG-Wert enthält.

[_Out_] Value

Ein Zeiger auf einen Speicherort, der die Daten empfängt, die dem Wert zugewiesen sind, den ValueName angibt.

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.

Hinweise

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

Anforderungen

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

Freigeben über