IEventControl::SetDefaultQuery, méthode (eventsys.h)

Définit la requête par défaut pour déterminer les abonnés.

Syntaxe

HRESULT SetDefaultQuery(
  [in]          BSTR methodName,
  [in]          BSTR criteria,
  [out, retval] int  *errorIndex
);

Paramètres

[in] methodName

Nom de la méthode à laquelle la requête par défaut est affectée.

[in] criteria

Critères de requête. Ce paramètre ne peut pas être NULL. Pour plus d’informations sur la formation d’une expression valide pour ce paramètre, consultez la section Remarques ci-dessous.

[out, retval] errorIndex

Emplacement, exprimé sous forme de décalage, d’une erreur dans le paramètre criteria .

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Les critères de requête spécifiés par le paramètre criteria peuvent être « ALL », pour spécifier une demande pour tous les objets d’abonnement, ou une expression booléenne indiquant une ou plusieurs conditions qu’un objet d’abonnement doit remplir pour être inclus dans le résultat de la requête. Les expressions valides se présentent sous la forme suivante :

[NOT] valeur de propertynamerelationalOperator. Les opérateurs relationnels valides sont les suivants :

==, =, !=, <>, ~=. Les valeurs valides sont « string », « string », {GUID}, TRUE, FALSE, NULL.

Les expressions booléennes individuelles peuvent être jointes à AND ou OR. Les expressions peuvent être imbriquées entre parenthèses pour appliquer un ordre d’évaluation spécifique.

Voici quelques exemples de critères de requête valides :

« EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} »

« EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} AND MethodName = 'StockPriceChange' »

Spécifications

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	eventsys.h

Voir aussi

IEventControl