NetConfigurationQueryMultiString 함수(netconfiguration.h)

지정된 구성 개체의 값 이름과 연결된 MultiString-valued 레지스트리 항목을 검색합니다.

구문

NTSTATUS NetConfigurationQueryMultiString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringsAttributes,
  [_Inout_]  WDFCOLLECTION         Collection
);

매개 변수

[_In_] Configuration

열린 레지스트리 키를 나타내는 NETCONFIGURATION 개체에 대한 핸들입니다.

[_In_] ValueName

디바이스의 소프트웨어 키에 값 이름이 포함된 UNICODE_STRING 구조체에 대한 포인터입니다.

[_In_opt_] StringsAttributes

새 WDFSTRING 개체에 대한 드라이버 제공 특성을 포함하는 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 WDF_NO_OBJECT_ATTRIBUTES 수 있습니다.

[_Inout_] Collection

드라이버 제공 컬렉션 개체에 대한 핸들입니다. 함수가 성공하면 ValueName에 할당된 각 문자열에 대한 WDFSTRING 개체가 포함됩니다.

반환 값

함수는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 레지스트리 값이 NULL이면 NetConfigurationQueryMultiString은STATUS_OBJECT_NAME_NOT_FOUND 반환합니다.

설명

클라이언트 드라이버는 NetAdapterOpenConfiguration 또는 NetConfigurationOpenSubConfiguration을 호출하여 NETCONFIGURATION 개체에 대한 핸들을 가져옵니다.

기본적으로 문자열은 컬렉션 개체에 부모로 지정됩니다. 클라이언트 드라이버는 WDF_OBJECT_ATTRIBUTES 구조체의 ParentObject 멤버를 설정하여 이를 변경할 수 있습니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.21
머리글	netconfiguration.h(netadaptercx.h 포함)
라이브러리	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL