Classe COleMessageFilter

Artigo
06/10/2015

Gerencia concorrência necessária por interação de aplicativos OLE.

class COleMessageFilter : public CCmdTarget

Membros

Construtores public

Nome	Descrição
COleMessageFilter::COleMessageFilter	Constrói um objeto de COleMessageFilter .

Métodos públicos

Nome	Descrição
COleMessageFilter::BeginBusyState	Colocar o aplicativo no estado ocupado.
COleMessageFilter::EnableBusyDialog	Ativar e desativar a caixa de diálogo que aparece quando um aplicativo é chamado ocupado.
COleMessageFilter::EnableNotRespondingDialog	Ativar e desativar a caixa de diálogo que aparece quando um aplicativo é chamado não responder.
COleMessageFilter::EndBusyState	Finaliza ocupado o estado do aplicativo.
COleMessageFilter::OnMessagePending	Chamado pela estrutura para processar mensagens quando uma chamada OLE está em andamento.
COleMessageFilter::Register	Registra o filtro de mensagem com as dlls VELHOS do sistema.
COleMessageFilter::Revoke	Revoga o registro de filtro de mensagem com as dlls VELHOS do sistema.
COleMessageFilter::SetBusyReply	Determina a resposta ocupado de aplicativo a uma chamada OLE.
COleMessageFilter::SetMessagePendingDelay	Determina quanto tempo o aplicativo aguarda uma resposta a uma chamada OLE.
COleMessageFilter::SetRetryReply	Determina a resposta do aplicativo de chamada para um aplicativo ocupado.

Comentários

A classe de COleMessageFilter é útil em aplicativos visuais do servidor e de contêiner de edição, bem como aplicativos VELHOS de automação. Para aplicativos de servidor que está sendo chamado, essa classe pode ser usada para fazer o aplicativo “ocupado” de modo que chamadas de entrada de outros aplicativos de contêiner serão canceladas ou experimentados de volta posteriormente. Essa classe também pode ser usada para determinar a ação a ser tomada por um aplicativo de chamada quando o aplicativo é chamado ocupado.

O uso comum é que um aplicativo para servidores chama BeginBusyState e EndBusyState quando seria perigoso para um documento ou outro objeto acessível OLE é destruído. Essas chamadas são feitas em CWinApp::OnIdle durante atualizações de interface do usuário.

Por padrão, um objeto de COleMessageFilter é atribuído quando o aplicativo é inicializado. Pode ser recuperada com AfxOleGetMessageFilter.

Esta é uma classe avançado; raramente você precisa trabalhar diretamente com ele.

Para obter mais informações, consulte o artigo servidores: implementando um servidor.