NetConfigurationOpenSubConfiguration - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
// netconfiguration.h

NTSTATUS NetConfigurationOpenSubConfiguration(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      SubConfigurationName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *SubConfiguration
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nf-netconfiguration-netconfigurationopensubconfiguration)

NetConfigurationOpenSubConfiguration function

Description

Opens a sub configuration of a specified adapter configuration object.

Parameters

Configuration [_In_]

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

SubConfigurationName [_In_]

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

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.

SubConfiguration [_Out_]

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.

See also

NetAdapterOpenConfiguration

View the official Windows Driver Kit DDI reference

Edit description on GitHub