NetConfigurationQueryLinkLayerAddress function (netconfiguration.h)

The NetConfigurationQueryLinkLayerAddress function retrieves the software-configurable link layer address that was stored in the registry for a NIC.

Syntax

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

Parameters

[_In_] Configuration

Handle to a NETCONFIGURATION object that represents an opened registry key.

[_Out_] LinkLayerAddress

A pointer to a NET_ADAPTER_LINK_LAYER_ADDRESS object that represents the link layer address stored in the registry key.

Return value

The function returns STATUS_SUCCESS if the operation succeeds. Otherwise, this function may return an appropriate NTSTATUS error code.

Remarks

The client driver obtains a handle to a NETCONFIGURATION object by calling NetAdapterOpenConfiguration or NetConfigurationOpenSubConfiguration.

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.23
Minimum UMDF version 2.33
Header netconfiguration.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL