IFunctionInstanceCollectionQuery::AddPropertyConstraint, méthode (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.]

Ajoute une contrainte de propriété à la requête.

Cette méthode limite les résultats des requêtes aux seules instances de fonction avec une clé de propriété (PKEY) correspondant à la contrainte spécifiée.

Syntaxe

HRESULT AddPropertyConstraint(
  [in] REFPROPERTYKEY     Key,
  [in] const PROPVARIANT  *pv,
  [in] PropertyConstraint enumPropertyConstraint
);

Paramètres

[in] Key

Clé de propriété (PKEY) de la contrainte. Pour plus d’informations sur les PKEYs, consultez Définitions de clés.

[in] pv

PROPVARIANT utilisé pour la contrainte. Ce type doit correspondre au type PROPVARIANT associé à Key.

Voici les valeurs possibles. Notez que seul un sous-ensemble des types PROPVARIANT pris en charge par les fournisseurs intégrés peut être utilisé comme contrainte de propriété.

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

Valeur PropertyConstraint qui spécifie le type de comparaison à utiliser lors de la comparaison du PKEY de la contrainte à la fonction PKEY de instance.

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.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	La contrainte spécifiée pour la requête n’est pas prise en charge. Soit la contrainte n’est pas prise en charge pour un type VARENUM spécifique, soit le type VARENUM n’est pas du tout pris en charge.

Notes

Une fonction instance correspondra uniquement à une contrainte de propriété lorsque le type PROPVARIANT du PKEY de la fonction instance correspond au type PROPVARIANT du PKEY de la contrainte et que la valeur PKEY de la fonction instance correspond à la valeur PKEY de la contrainte à l’aide de l’opérateur de comparaison spécifié par enumPropertyConstraint.

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

Spécifications

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

Requêtes de découverte de fonction

IFunctionInstanceCollectionQuery