Método IFunctionInstanceCollectionQuery::AddQueryConstraint (functiondiscoveryapi.h)

[La detección de funciones está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

El método AddQueryConstraint agrega una restricción de consulta a la consulta.

Este método permite a la aplicación filtrar el conjunto de resultados solo en las instancias que cumplen esta restricción.

Sintaxis

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

Parámetros

[in] pszConstraintName

Restricción de consulta.

[in] pszConstraintValue

Valor de restricción.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código devuelto Descripción
S_OK
El método se completó correctamente.
E_OUTOFMEMORY
El método no puede asignar la memoria necesaria para realizar esta operación.

Comentarios

Si se agregan varias restricciones, se deben admitir todas las restricciones para satisfacer la consulta.

AddQueryConstraint producirá un error si el objeto IFunctionInstanceCollectionQuery incluye todas las subcategorías y se llama al método AddQueryConstraint con el parámetro pszConstraintName establecido en FD_QUERYCONSTRAINT_PROVIDERINSTANCEID. Para evitar este error, cree un objeto IFunctionInstanceCollectionQuery que no incluya todas las subcategorías. Puede crear este objeto llamando a CreateInstanceCollectionQuery con el parámetro fIncludeAllSubCategories establecido en false.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado functiondiscoveryapi.h
Archivo DLL FunDisc.dll

Consulte también

Definiciones de restricciones

Consultas de detección de funciones

IFunctionInstanceCollectionQuery