DevCreateObjectQueryEx 함수(devquery.h)

지정된 쿼리 매개 변수 및 확장 매개 변수를 기반으로 속성을 검색하는 디바이스 쿼리를 만듭니다.

통사론

HRESULT DevCreateObjectQueryEx(
  [in]           DEV_OBJECT_TYPE                 ObjectType,
  [in]           ULONG                           QueryFlags,
  [in]           ULONG                           cRequestedProperties,
  [in]           const DEVPROPCOMPKEY            *pRequestedProperties,
  [in]           ULONG                           cFilterExpressionCount,
  [in, optional] const DEVPROP_FILTER_EXPRESSION *pFilter,
  [in]           ULONG                           cExtendedParameterCount,
  [in, optional] const DEV_QUERY_PARAMETER       *pExtendedParameters,
  [in]           PDEV_QUERY_RESULT_CALLBACK      pCallback,
  [in, optional] PVOID                           pContext,
  [out]          PHDEVQUERY                      phDevQuery
);

매개 변수

[in] ObjectType

이 쿼리가 작동해야 하는 개체 형식을 결정하는 DEV_OBJECT_TYPE 열거형의 값입니다.

[in] QueryFlags

비트 OR 연산을 사용하여 결합된 DEV_QUERY_FLAGS 값의 조합입니다.

[in] cRequestedProperties

pRequestedProperties제공된 DEVPROPCOMPKEY 구조의 수입니다. DevQueryFlagAllProperties 지정한 경우 0으로 설정해야 합니다.

[in] pRequestedProperties

필요에 따라 pCallback 호출될 때 쿼리 결과 집합의 개체에 대해 검색해야 하는 속성을 지정하는 DEVPROPCOMPKEY 구조체의 배열을 제공하여 결과 집합에 개체가 추가되었음을 쿼리에 알립니다.
DevQueryFlagUpdateResultsQueryFlags지정한 경우 쿼리의 결과 집합에 있는 개체에 대해 이러한 속성 값이 변경되면 쿼리에 알림이 표시됩니다.

DEVPROPCOMPKEY 구조체의 LocaleName 필드는 무시되며 NULL로 설정해야 합니다.

cRequestedProperties 0이면 NULL이어야 합니다.

[in] cFilterExpressionCount

pFilter제공된 DEVPROP_FILTER_EXPRESSION 구조체의 수입니다.

[in, optional] pFilter

필요에 따라 쿼리 결과 집합의 일부여야 하는 개체에 대한 필터 조건을 지정하는 DEVPROP_FILTER_EXPRESSION 구조의 배열을 제공합니다. cFilterExpressionCount 0이면 NULL이어야 합니다.

[in] cExtendedParameterCount

시스템 사용을 위해 예약되어 있습니다. 0으로 설정해야 합니다.

[in, optional] pExtendedParameters

시스템 사용을 위해 예약되어 있습니다. NULL로 설정해야 합니다.

[in] pCallback

이 쿼리의 결과를 나타내는 PDEV_QUERY_RESULT_CALLBACK 콜백 함수를 보내야 합니다.

[in, optional] pContext

호출자가 제공한 컨텍스트입니다. 이 값은 수정되지 않은 콜백 함수에 전달됩니다.

[out] phDevQuery

쿼리를 나타내는 핸들을 받는 포인터입니다. DevQueryFlagsUpdateResults 지정한 경우 쿼리는 핸들이 닫힙니다. DevCloseObjectQuery 호출하여 이 핸들을 닫아 쿼리를 중지합니다.

반환 값

쿼리가 성공적으로 만들어진 경우 S_OK 반환됩니다. 그렇지 않으면 적절한 오류 값입니다.

발언

자세한 내용은 이 함수에도 적용되는 DevCreateObjectQuery설명 및 예제 섹션을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 10 버전 1809
지원되는 최소 서버	Windows Server 2019
헤더	devquery.h
라이브러리	Onecore.lib
DLL	Cfgmgr32.dll

참고 항목

DevCreateObjectQuery