NetConfigurationOpenSubConfiguration 函式 （netconfiguration.h）
開啟指定配接器組態物件的子組態。
語法
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
參數
[_In_] Configuration
在先前呼叫 NetAdapterOpenConfiguration 或 NetConfigurationOpenSubConfiguration中開啟之配接器組態物件的句柄。
[_In_] SubConfigurationName
字串的指標，指定要開啟之子組態的名稱。
[_In_opt_] SubConfigurationAttributes
WDF_OBJECT_ATTRIBUTES 結構的指標，其中包含新組態對象的驅動程式提供屬性。 這個參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。
[_Out_] SubConfiguration
接收新子組態物件句柄之位置的指標。
傳回值
如果作業成功，函式會傳回STATUS_SUCCESS。 否則，此函式可能會傳回適當的NTSTATUS錯誤碼。
言論
如果用戶端提供 WDF_OBJECT_ATTRIBUTES，它會指定 ParentObjectNULL。 根據預設，子組態會父系至現有的配接器組態物件。
用戶端驅動程式會使用子組態物件或父配接器組態物件呼叫 NetConfigurationClose 來關閉子組態。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.21 |
| 最低 UMDF 版本 | 2.33 |
| 標頭 | netconfiguration.h （包括 netadaptercx.h） |
| 連結庫 | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |