NetConfigurationQueryUlong-Funktion (netconfiguration.h)

Ruft die angegebenen unsigned long word (REG_DWORD)-Daten 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 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 entsprechenden NTSTATUS-Fehlercode zurück.

Hinweise

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

Anforderungen

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