Compartilhar via


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

Prepara um filtro de editor para começar a disparar uma lista filtrada de assinaturas usando um controle de disparo fornecido. O controle de disparo está contido no objeto de classe de evento.

Esse método tem suporte apenas para compatibilidade com versões anteriores. Caso contrário, você deve usar os métodos da interface IMultiInterfacePublisherFilter .

Sintaxe

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

Parâmetros

[in] methodName

O nome do método de evento a ser acionado.

[in] firingControl

Um ponteiro para a interface IFiringControl no objeto de controle de disparo.

Retornar valor

Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL, bem como os valores a seguir.

Código de retorno Descrição
S_OK
O objeto de classe de evento está pronto para disparar o evento.
EVENT_S_SOME_SUBSCRIBERS_FAILED
Um evento foi capaz de invocar alguns, mas não todos, dos assinantes.
EVENT_E_ALL_SUBSCRIBERS_FAILED
Um evento não pôde invocar nenhum dos assinantes.
EVENT_S_NOSUBSCRIBERS
Um evento foi publicado, mas não havia assinantes.
EVENT_E_QUERYSYNTAX
Ocorreu um erro de sintaxe ao tentar avaliar uma cadeia de caracteres de consulta.
EVENT_E_QUERYFIELD
Um nome de campo inválido foi usado em uma cadeia de caracteres de consulta.
EVENT_E_INTERNALEXCEPTION
Uma exceção inesperada foi gerada.
EVENT_E_INTERNALERROR
Um erro interno inesperado foi detectado.
EVENT_E_INVALID_PER_USER_SID
O SID proprietário em uma assinatura por usuário não existe.
EVENT_E_USER_EXCEPTION
Um componente ou assinante fornecido pelo usuário gerou uma exceção.
EVENT_E_TOO_MANY_METHODS
Uma interface tem muitos métodos para disparar eventos.
EVENT_E_MISSING_EVENTCLASS
Uma assinatura não pode ser armazenada, a menos que a classe de evento da assinatura já exista.
EVENT_E_NOT_ALL_REMOVED
Nem todos os objetos solicitados puderam ser removidos.
EVENT_E_COMPLUS_NOT_INSTALLED
O COM+ é necessário para essa operação, mas não está instalado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho eventsys.h

Confira também

IMultiInterfacePublisherFilter

IPublisherFilter