IPublisherFilter ::P repareToFire, méthode (eventsys.h)

Article
02/29/2024

Prépare un filtre d’éditeur pour commencer à déclencher une liste filtrée d’abonnements à l’aide d’un contrôle de déclenchement fourni. Le contrôle de déclenchement est contenu dans l’objet de classe d’événements.

Cette méthode est prise en charge uniquement pour la compatibilité descendante. Sinon, vous devez utiliser les méthodes de l’interface IMultiInterfacePublisherFilter .

Syntaxe

HRESULT PrepareToFire(
  [in] BSTR           methodName,
  [in] IFiringControl *firingControl
);

Paramètres

[in] methodName

Nom de la méthode d’événement à déclencher.

[in] firingControl

Pointeur vers l’interface IFiringControl sur l’objet de contrôle de déclenchement.

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	L’objet de classe d’événements est prêt à déclencher l’événement.
EVENT_S_SOME_SUBSCRIBERS_FAILED	Un événement a pu appeler certains abonnés, mais pas tous.
EVENT_E_ALL_SUBSCRIBERS_FAILED	Un événement n’a pas pu appeler l’un des abonnés.
EVENT_S_NOSUBSCRIBERS	Un événement a été publié, mais il n’y avait pas d’abonnés.
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_INTERNALEXCEPTION	Une exception inattendue a été levée.
EVENT_E_INTERNALERROR	Une erreur interne inattendue a été détectée.
EVENT_E_INVALID_PER_USER_SID	Le SID propriétaire d’un abonnement par utilisateur n’existe pas.
EVENT_E_USER_EXCEPTION	Un composant ou un abonné fourni par l’utilisateur a déclenché une exception.
EVENT_E_TOO_MANY_METHODS	Une interface a trop de méthodes à partir desquelles déclencher des événements.
EVENT_E_MISSING_EVENTCLASS	Un abonnement ne peut pas être stocké, sauf si la classe d’événements de l’abonnement existe déjà.
EVENT_E_NOT_ALL_REMOVED	Tous les objets demandés n’ont pas pu être supprimés.
EVENT_E_COMPLUS_NOT_INSTALLED	COM+ est requis pour cette opération, mais il n’est pas installé.

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

IMultiInterfacePublisherFilter

IPublisherFilter

Partager via