Метод IFunctionInstanceCollectionQuery::AddPropertyConstraint (functiondiscoveryapi.h)

[Функция обнаружения доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Добавляет в запрос ограничение свойства.

Этот метод ограничивает результаты запроса только экземплярами функций с ключом свойства (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

Значение PropertyConstraint , указывающее тип сравнения, используемого при сравнении PKEY ограничения с PKEY экземпляра функции.

Возвращаемое значение

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата	Описание
S_OK	Метод завершился успешно.
E_OUTOFMEMORY	Метод не может выделить память, необходимую для выполнения этой операции.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Ограничение, указанное для запроса, не поддерживается. Ограничение не поддерживается для определенного типа VARENUM или тип VARENUM не поддерживается вообще.

Комментарии

Экземпляр функции будет соответствовать ограничению свойства, только если тип PROPVARIANT PKEY экземпляра функции соответствует типу PROPVARIANT PKEY ограничения, а значение PKEY экземпляра функции соответствует значению PKEY ограничения с помощью оператора сравнения, заданного параметром enumPropertyConstraint.

При добавлении нескольких ограничений все ограничения должны поддерживаться для удовлетворения запроса.

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	functiondiscoveryapi.h
DLL	FunDisc.dll

См. также раздел

Запросы обнаружения функций

IFunctionInstanceCollectionQuery