Partager via

Méthode IEventSystem ::RemoveS (eventsys.h)

  • Article

Supprime un ou plusieurs objets d’abonnement ou d’événement du magasin de données d’événements.

Syntaxe

HRESULT RemoveS(
  [in] BSTR progID,
  [in] BSTR queryCriteria
);

Paramètres

[in] progID

ProgID de la classe d’objet à supprimer. Il doit s’agir d’un identificateur de classe d’objet d’événement valide. Ce paramètre peut être l’une des valeurs suivantes :

  • PROGID_EventClass
  • PROGID_EventClassCollection
  • PROGID_EventSubscription
  • PROGID_EventSubscriptionCollection

[in] queryCriteria

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

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED et E_FAIL, ainsi que les valeurs suivantes.

Code de retour Description
S_OK
 La commande s'est correctement terminée.
EVENT_E_QUERYSYNTAX
 Une erreur de syntaxe s’est produite lors de la tentative d’évaluation d’une chaîne de requête.
EVENT_E_QUERYFIELD
 Un nom de champ non valide a été utilisé dans une chaîne de requête.
EVENT_E_NOT_ALL_REMOVED
 Tous les objets demandés n’ont pas pu être supprimés.

Remarques

Les critères de requête spécifiés par le paramètre queryCriteria peuvent être « ALL », pour spécifier une requête 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 sont de 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' »

Configuration requise

Condition requise Valeur
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

IEventSystem