Método IPublisherFilter::P repareToFire (eventsys.h)

  • Artículo

Prepara un filtro de publicador para empezar a activar una lista filtrada de suscripciones mediante un control de activación proporcionado. El control de activación está incluido en el objeto de clase de evento.

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 PrepareToFire(
  [in] BSTR           methodName,
  [in] IFiringControl *firingControl
);

Parámetros

[in] methodName

Nombre del método de evento que se va a desencadenar.

[in] firingControl

Puntero a la interfaz IFiringControl del objeto de control de activación.

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 objeto de clase de evento está listo para desencadenar el evento.
EVENT_S_SOME_SUBSCRIBERS_FAILED
 Un evento pudo invocar algunos suscriptores, pero no todos.
EVENT_E_ALL_SUBSCRIBERS_FAILED
 Un evento no pudo invocar a 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 generó una excepción inesperada.
EVENT_E_INTERNALERROR
 Se detectó un error interno inesperado.
EVENT_E_INVALID_PER_USER_SID
 El SID propietario de 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
 No se puede almacenar una suscripción a menos que ya exista la clase de eventos de la suscripción.
EVENT_E_NOT_ALL_REMOVED
 No se podrían quitar todos los objetos solicitados.
EVENT_E_COMPLUS_NOT_INSTALLED
 COM+ es necesario para esta operación, pero no está instalado.

Requisitos

Requisito Value
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