NetConfigurationOpenSubConfiguration function (netconfiguration.h)
Opens a sub configuration of a specified adapter configuration object.
Syntax
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
Parameters
[_In_] Configuration
A handle to an adapter configuration object opened in a prior call to NetAdapterOpenConfiguration or NetConfigurationOpenSubConfiguration.
[_In_] SubConfigurationName
A pointer to a string specifying the name of the sub configuration to open.
[_In_opt_] SubConfigurationAttributes
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.
[_Out_] SubConfiguration
A pointer to a location that receives a handle to the new sub configuration object.
Return value
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.
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 |