NetConfigurationQueryUlong function (netconfiguration.h)

Article
05/22/2024

Retrieves the specified unsigned long word (REG_DWORD) data from the adapter configuration object and copies the data to a specified location.

Syntax

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

Parameters

[_In_] Configuration

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

[_In_] Flags

A valid bitwise OR of NET_CONFIGURATION_QUERY_ULONG_FLAGS-typed flags.

[_In_] ValueName

A pointer to a UNICODE_STRING structure that contains a name for the ULONG value.

[_Out_] Value

A pointer to a location that receives the data that is assigned to the value that ValueName specifies.

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.21
Minimum UMDF version	2.33
Header	netconfiguration.h (include netadaptercx.h)
Library	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Share via