NetConfigurationQueryBinary 함수(netconfiguration.h)

현재 지정된 레지스트리 값에 할당된 데이터를 검색하고, 프레임워크 할당 버퍼에 데이터를 저장하고, 버퍼를 나타내는 프레임워크 메모리 개체를 만듭니다.

구문

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

매개 변수

[_In_] Configuration

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

[_In_] ValueName

값 이름을 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다.

[_In_] PoolType

데이터 버퍼에 할당할 메모리 유형을 지정하는 POOL_TYPE 형식의 값입니다.

[_In_opt_] MemoryAttributes

새 메모리 개체에 대한 개체 특성을 포함하는 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 WDF_NO_OBJECT_ATTRIBUTES 수 있습니다.

[_Out_] Memory

새 메모리 개체에 대한 핸들을 수신하는 위치에 대한 포인터입니다. 프레임워크는 이 메모리 버퍼를 할당하고 NETCONFIGURATION 개체가 닫히면 자동으로 해제합니다.

반환 값

함수는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 함수가 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.

설명

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

이 함수에 의해 할당된 메모리는 NETCONFIGURATION 개체가 닫히면 프레임워크에서 자동으로 해제됩니다.

요구 사항

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