Skip to content

Latest commit

 

History

History
80 lines (60 loc) · 2.83 KB

nf-netadapter-netadapteropenconfiguration.md

File metadata and controls

80 lines (60 loc) · 2.83 KB
UID title description tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.lib req.dll req.irql req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.alt-api req.alt-loc req.typenames targetos f1_keywords topic_type api_type api_location api_name
NF:netadapter.NetAdapterOpenConfiguration
NetAdapterOpenConfiguration function (netadapter.h)
Opens the adapter’s configuration database.
netvista
03/30/2022
NetAdapterOpenConfiguration function
NetAdapterOpenConfiguration
netadapter.h
netadaptercx.h
Universal
1.21
NetAdapterCxStub.lib
PASSIVE_LEVEL
NetAdapterOpenConfiguration
Windows
NetAdapterOpenConfiguration
netadapter/NetAdapterOpenConfiguration
apiref
HeaderDef
netadapter.h
NetAdapterOpenConfiguration

NetAdapterOpenConfiguration function

-description

The NetAdapterOpenConfiguration function opens a net adapter’s configuration database.

-parameters

-param Adapter [In]

The network adapter object that the client created in a prior call to NetAdapterCreate.

-param ConfigurationAttributes [In_opt]

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

-param Configuration [Out]

A pointer to a location that receives a handle to the new adapter configuration object.

-returns

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

-remarks

Typically, the client calls this function from its EVT_WDF_DRIVER_DEVICE_ADD callback function.

If the client provides a WDF_OBJECT_ATTRIBUTES, it specifies NULL for ParentObject. The adapter configuration object is automatically parented to the adapter object.

As a result, WDF automatically deletes the configuration object when the adapter is deleted. However, the client can manually delete a configuration object by calling WdfObjectDelete, typically from its EVT_WDF_OBJECT_CONTEXT_CLEANUP callback function.

-see-also

Accessing configuration information

NetConfigurationClose