NetConfigurationQueryUlong-Funktion (netconfiguration.h)

Artikel
02/07/2025

Ruft die angegebenen nicht signierten langen Wortdaten (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

Behandeln Sie ein NETCONFIGURATION -Objekt, das einen geöffneten Registrierungsschlüssel darstellt.

[_In_] Flags

Ein gültiger bitweiser OR von NET_CONFIGURATION_QUERY_ULONG_FLAGS-typed 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, der 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.

Bemerkungen

Der Clienttreiber ruft ein Handle für ein NETCONFIGURATION -Objekt ab, indem NetAdapterOpenConfiguration oder NetConfigurationOpenSubConfigurationaufgerufen wird.

Anforderungen

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

Freigeben über