Método IPublisherFilter::Initialize (eventsys.h)

  • Artículo

Asocia un método de evento a una colección de objetos de suscripción.

Este método solo se admite para la compatibilidad con versiones anteriores. De lo contrario, debe usar los métodos de la interfaz IMultiInterfacePublisherFilter .

Sintaxis

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

Parámetros

[in] methodName

Nombre del método de evento asociado al filtro del publicador.

[in] dispUserDefined

Puntero a la interfaz IEventSystem de un objeto del sistema de eventos o a la interfaz IEventControl en un objeto de clase de evento.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED y E_FAIL, así como los siguientes valores.

Código devuelto Descripción
S_OK
 El filtro del publicador se inicializó correctamente.
EVENT_S_SOME_SUBSCRIBERS_FAILED
 Un evento pudo invocar algunos suscriptores, pero no todos.
EVENT_E_ALL_SUBSCRIBERS_FAILED
 Un evento no pudo invocar ninguno de los suscriptores.
EVENT_S_NOSUBSCRIBERS
 Se publicó un evento, pero no había suscriptores.
EVENT_E_QUERYSYNTAX
 Error de sintaxis al intentar evaluar una cadena de consulta.
EVENT_E_QUERYFIELD
 Se usó un nombre de campo no válido en una cadena de consulta.
EVENT_E_INTERNALEXCEPTION
 Se ha producido una excepción inesperada.
EVENT_E_INTERNALERROR
 Se detectó un error interno inesperado.
EVENT_E_INVALID_PER_USER_SID
 El SID de propietario en una suscripción por usuario no existe.
EVENT_E_USER_EXCEPTION
 Un componente o suscriptor proporcionado por el usuario generó una excepción.
EVENT_E_TOO_MANY_METHODS
 Una interfaz tiene demasiados métodos de los que se desencadenan eventos.
EVENT_E_MISSING_EVENTCLASS
 Una suscripción no se puede almacenar a menos que la clase de eventos de la suscripción ya exista.
EVENT_E_NOT_ALL_REMOVED
 No se pueden quitar todos los objetos solicitados.
EVENT_E_COMPLUS_NOT_INSTALLED
 COM+ es necesario para esta operación, pero no está instalado.

Comentarios

El filtro de publicador usa el puntero pasado en dispUserDefined para obtener una lista de suscriptores, ya sea llamando a IEventSystem::Query o IEventControl::GetSubscriptions.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado eventsys.h

Consulte también

IMultiInterfacePublisherFilter

IPublisherFilter