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 제공하는 경우 ParentObject에 대해 NULL을 지정합니다. 기본적으로 하위 구성은 기존 어댑터 구성 개체에 부모로 지정됩니다.

클라이언트 드라이버는 하위 구성 개체 또는 부모 어댑터 구성 개체를 사용하여 NetConfigurationClose 를 호출하여 하위 구성을 닫습니다.

요구 사항

추가 정보

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration