Skip to content

Latest commit

 

History

History
82 lines (60 loc) · 2.79 KB

nf-netconfiguration-netconfigurationopensubconfiguration.md

File metadata and controls

82 lines (60 loc) · 2.79 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 targetos f1_keywords topic_type api_type api_location api_name
NF:netconfiguration.NetConfigurationOpenSubConfiguration
NetConfigurationOpenSubConfiguration function (netconfiguration.h)
Opens a sub configuration of a specified adapter configuration object.
netvista
03/30/2022
NetConfigurationOpenSubConfiguration function
NetConfigurationOpenSubConfiguration
netconfiguration.h
netadaptercx.h
Universal
1.21
NetAdapterCxStub.lib
PASSIVE_LEVEL
Windows
NetConfigurationOpenSubConfiguration
netconfiguration/NetConfigurationOpenSubConfiguration
apiref
HeaderDef
netconfiguration.h
NetConfigurationOpenSubConfiguration

NetConfigurationOpenSubConfiguration function

-description

Opens a sub configuration of a specified adapter configuration object.

-parameters

-param Configuration [In]

A handle to an adapter configuration object opened in a prior call to NetAdapterOpenConfiguration or NetConfigurationOpenSubConfiguration.

-param SubConfigurationName [In]

A pointer to a string specifying the name of the sub configuration to open.

-param SubConfigurationAttributes [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 SubConfiguration [Out]

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

-returns

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

-remarks

If the client provides a WDF_OBJECT_ATTRIBUTES, it specifies NULL for ParentObject. By default, the sub configuration is parented to the existing adapter configuration object.

The client driver closes the sub configuration by calling NetConfigurationClose with either the sub configuration object or the parent adapter configuration object.

-see-also

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration