NetConfigurationQueryLinkLayerAddress-Funktion (netconfiguration.h)

  • Artikel

Die NetConfigurationQueryLinkLayerAddress-Funktion ruft die softwarekonfigurierbare Linkebenenadresse ab, die in der Registrierung für eine NIC gespeichert wurde.

Syntax

NTSTATUS NetConfigurationQueryLinkLayerAddress(
  [_In_]  NETCONFIGURATION               Configuration,
  [_Out_] NET_ADAPTER_LINK_LAYER_ADDRESS *LinkLayerAddress
);

Parameter

[_In_] Configuration

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

[_Out_] LinkLayerAddress

Ein Zeiger auf ein NET_ADAPTER_LINK_LAYER_ADDRESS-Objekt, das die im Registrierungsschlüssel gespeicherte Linkebenenadresse darstellt.

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.23
Kopfzeile netconfiguration.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL