NetConfigurationQueryBinary function (netconfiguration.h)

Retrieves the data that is currently assigned to a specified registry value, stores the data in a framework-allocated buffer, and creates a framework memory object to represent the buffer.

Syntax

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

Parameters

[_In_] Configuration

A handle to a NETCONFIGURATION object that represents an opened registry key.

[_In_] ValueName

A pointer to a UNICODE_STRING structure that contains a value name.

[_In_] PoolType

A POOL_TYPE-typed value that specifies the type of memory to be allocated for the data buffer.

[_In_opt_] MemoryAttributes

A pointer to a WDF_OBJECT_ATTRIBUTES structure that contains object attributes for the new memory object. This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Memory

A pointer to a ___location that receives a handle to the new memory object. The framework allocates this memory buffer and automatically frees it when the NETCONFIGURATION object is closed.

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.

The memory allocated by this function is automatically freed by the framework when the NETCONFIGURATION object is closed.

Requirements