[함수 검색은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
쿼리에 속성 제약 조건을 추가합니다.
이 메서드는 지정된 제약 조건과 일치하는 PKEY(속성 키)가 있는 함수 인스턴스로만 쿼리 결과를 제한합니다.
구문
HRESULT AddPropertyConstraint(
[in] REFPROPERTYKEY Key,
[in] const PROPVARIANT *pv,
[in] PropertyConstraint enumPropertyConstraint
);
매개 변수
[in] Key
제약 조건에 대한 PKEY(속성 키)입니다. PKEY에 대한 자세한 내용은 키 정의를 참조하세요.
[in] pv
제약 조건에 사용되는 PROPVARIANT 입니다. 이 형식은 키와 연결된 PROPVARIANT 형식과 일치해야 합니다.
다음은 가능한 값을 보여줍니다. 기본 제공 공급자에서 지원하는 PROPVARIANT 형식의 하위 집합만 속성 제약 조건으로 사용할 수 있습니다.
VT_BOOL
VT_I2
VT_I4
VT_I8
VT_INT
VT_LPWSTR
VT_LPWSTR|VT_VECTOR
VT_UI2
VT_UI4
VT_UI8
VT_UINT
[in] enumPropertyConstraint
제약 조건의 PKEY를 함수 instance PKEY와 비교할 때 사용할 비교 유형을 지정하는 PropertyConstraint 값입니다.
반환 값
가능한 반환 값은 다음을 포함하지만 이에 국한되지 않습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
메서드는 이 작업을 수행하는 데 필요한 메모리를 할당할 수 없습니다. |
|
쿼리에 지정된 제약 조건은 지원되지 않습니다. 특정 VARENUM 형식에 대해 제약 조건이 지원되지 않거나 VARENUM 형식이 전혀 지원되지 않습니다. |
설명
함수 instance 함수 instance PKEY의 PROPVARIANT 형식이 제약 조건 PKEY의 PROPVARIANT 형식과 일치하고 함수 instance PKEY 값이 enumPropertyConstraint로 지정된 비교 연산자를 사용하여 제약 조건의 PKEY 값과 일치하는 경우에만 속성 제약 조건과 일치합니다.
여러 제약 조건이 추가되면 쿼리를 충족하려면 모든 제약 조건이 지원되어야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | functiondiscoveryapi.h |
| DLL | FunDisc.dll |