IFunctionInstanceCollectionQuery::AddQueryConstraint 메서드(functiondiscoveryapi.h)

[함수 검색은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

AddQueryConstraint 메서드는 쿼리에 쿼리 제약 조건을 추가합니다.

이 메서드를 사용하면 애플리케이션이 결과 집합을 이 제약 조건을 충족하는 인스턴스로만 필터링할 수 있습니다.

구문

HRESULT AddQueryConstraint(
  [in] const WCHAR *pszConstraintName,
  [in] const WCHAR *pszConstraintValue
);

매개 변수

[in] pszConstraintName

쿼리 제약 조건입니다.

[in] pszConstraintValue

제약 조건 값입니다.

반환 값

가능한 반환 값은 다음을 포함하지만 이에 국한되지 않습니다.

설명

여러 제약 조건이 추가되면 쿼리를 충족하려면 모든 제약 조건이 지원되어야 합니다.

IFunctionInstanceCollectionQuery 개체에 모든 하위 범주가 포함되어 있고 pszConstraintName 매개 변수가 FD_QUERYCONSTRAINT_PROVIDERINSTANCEID 설정된 상태에서 AddQueryConstraint 메서드가 호출되면 AddQueryConstraint가 오류와 함께 실패합니다. 이 오류를 방지하려면 모든 하위 범주를 포함하지 않는 IFunctionInstanceCollectionQuery 개체를 만듭니다. fIncludeAllSubCategories 매개 변수가 false로 설정된 CreateInstanceCollectionQuery를 호출하여 이러한 개체를 만들 수 있습니다.

요구 사항

추가 정보

제약 조건 정의

함수 검색 쿼리

IFunctionInstanceCollectionQuery