IPublisherFilter::P repareToFire-Methode (eventsys.h)

Artikel
02/26/2024

Bereitet einen Herausgeberfilter auf das Auslösen einer gefilterten Liste von Abonnements mithilfe eines bereitgestellten Auslösungssteuerelements vor. Das Auslösungssteuerelement ist im Ereignisklassenobjekt enthalten.

Diese Methode wird nur aus Gründen der Abwärtskompatibilität unterstützt. Andernfalls sollten Sie die Methoden der IMultiInterfacePublisherFilter-Schnittstelle verwenden.

Syntax

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

Parameter

[in] methodName

Der Name der ereignisbasierten Methode, die ausgelöst werden soll.

[in] firingControl

Ein Zeiger auf die IFiringControl-Schnittstelle des auslösenden Steuerelementobjekts.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED und E_FAIL sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Das Ereignisklassenobjekt ist bereit, das Ereignis auszulösen.
EVENT_S_SOME_SUBSCRIBERS_FAILED	Ein Ereignis konnte einige, aber nicht alle Abonnenten aufrufen.
EVENT_E_ALL_SUBSCRIBERS_FAILED	Ein Ereignis konnte keines der Abonnenten aufrufen.
EVENT_S_NOSUBSCRIBERS	Es wurde ein Ereignis veröffentlicht, aber es gab keine Abonnenten.
EVENT_E_QUERYSYNTAX	Beim Auswerten einer Abfragezeichenfolge ist ein Syntaxfehler aufgetreten.
EVENT_E_QUERYFIELD	In einer Abfragezeichenfolge wurde ein ungültiger Feldname verwendet.
EVENT_E_INTERNALEXCEPTION	Eine unerwartete Ausnahme wurde ausgelöst.
EVENT_E_INTERNALERROR	Ein unerwarteter interner Fehler wurde erkannt.
EVENT_E_INVALID_PER_USER_SID	Die Besitzer-SID für ein Benutzerabonnement ist nicht vorhanden.
EVENT_E_USER_EXCEPTION	Eine vom Benutzer bereitgestellte Komponente oder Abonnent hat eine Ausnahme ausgelöst.
EVENT_E_TOO_MANY_METHODS	Eine Schnittstelle verfügt über zu viele Methoden zum Auslösen von Ereignissen.
EVENT_E_MISSING_EVENTCLASS	Ein Abonnement kann nur gespeichert werden, wenn die Ereignisklasse für das Abonnement bereits vorhanden ist.
EVENT_E_NOT_ALL_REMOVED	Nicht alle angeforderten Objekte konnten entfernt werden.
EVENT_E_COMPLUS_NOT_INSTALLED	COM+ ist für diesen Vorgang erforderlich, aber nicht installiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	eventsys.h

Weitere Informationen

IMultiInterfacePublisherFilter

IPublisherFilter

Freigeben über