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 |
Header | netconfiguration.h (include netadaptercx.h) |
Library | NetAdapterCxStub.lib |
IRQL | PASSIVE_LEVEL |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for