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

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

Метод AddQueryConstraint добавляет в запрос ограничение запроса.

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

Синтаксис

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

Параметры

[in] pszConstraintName

Ограничение запроса.

[in] pszConstraintValue

Значение ограничения.

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

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

Код возврата	Описание
S_OK	Метод завершился успешно.
E_OUTOFMEMORY	Метод не может выделить память, необходимую для выполнения этой операции.

Комментарии

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

AddQueryConstraint завершится ошибкой, если объект IFunctionInstanceCollectionQuery включает все подкатегории и вызывается метод AddQueryConstraint с параметром pszConstraintName, для FD_QUERYCONSTRAINT_PROVIDERINSTANCEID. Чтобы избежать этой ошибки, создайте объект IFunctionInstanceCollectionQuery , который не включает все подкатегории. Такой объект можно создать, вызвав CreateInstanceCollectionQuery с параметром fIncludeAllSubCategories , равным false.

Требования

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

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

Определения ограничений

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

IFunctionInstanceCollectionQuery