IPublisherFilter::Initialize-Methode (eventsys.h)

Artikel
08/23/2023

Ordnet einer Auflistung von Abonnementobjekten eine Ereignismethode zu.

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

Syntax

HRESULT Initialize(
  [in] BSTR      methodName,
  [in] IDispatch *dispUserDefined
);

Parameter

[in] methodName

Der Name der Ereignismethode, die dem Herausgeberfilter zugeordnet ist.

[in] dispUserDefined

Ein Zeiger auf die IEventSystem-Schnittstelle in einem Ereignissystemobjekt oder auf die IEventControl-Schnittstelle für ein Ereignisklassenobjekt.

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	Der Herausgeberfilter wurde erfolgreich initialisiert.
EVENT_S_SOME_SUBSCRIBERS_FAILED	Ein Ereignis konnte einige, aber nicht alle Abonnenten aufrufen.
EVENT_E_ALL_SUBSCRIBERS_FAILED	Ein Ereignis konnte keinen 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	Es wurde eine unerwartete Ausnahme 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 ein Abonnent hat eine Ausnahme ausgelöst.
EVENT_E_TOO_MANY_METHODS	Eine Schnittstelle verfügt über zu viele Methoden, mit denen Ereignisse ausgelöst werden können.
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 es ist nicht installiert.

Hinweise

Der Herausgeberfilter verwendet den in dispUserDefined übergebenen Zeiger, um eine Liste von Abonnenten abzurufen, entweder durch Aufrufen von IEventSystem::Query oder IEventControl::GetSubscriptions.

Anforderungen


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