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

[La découverte de fonctions peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La méthode AddQueryConstraint ajoute une contrainte de requête à la requête.

Cette méthode permet à l’application de filtrer le jeu de résultats uniquement sur les instances qui remplissent cette contrainte.

Syntaxe

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

Paramètres

[in] pszConstraintName

Contrainte de requête.

[in] pszConstraintValue

Valeur de contrainte.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
E_OUTOFMEMORY	La méthode ne peut pas allouer la mémoire nécessaire pour effectuer cette opération.

Remarques

Si plusieurs contraintes sont ajoutées, toutes les contraintes doivent être prises en charge pour satisfaire la requête.

AddQueryConstraint échoue avec une erreur si l’objet IFunctionInstanceCollectionQuery inclut toutes les sous-catégories et si la méthode AddQueryConstraint est appelée avec le paramètre pszConstraintName défini sur FD_QUERYCONSTRAINT_PROVIDERINSTANCEID. Pour éviter cette erreur, créez un objet IFunctionInstanceCollectionQuery qui n’inclut pas toutes les sous-catégories. Vous pouvez créer un tel objet en appelant CreateInstanceCollectionQuery avec le paramètre fIncludeAllSubCategories défini sur false.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	functiondiscoveryapi.h
DLL	FunDisc.dll

Voir aussi

Définitions de contraintes

Requêtes de découverte de fonction

IFunctionInstanceCollectionQuery