IXPLogon::FlushQueues
Aplica-se a: Outlook 2013 | Outlook 2016
Solicita que o provedor de transporte entregue imediatamente todas as mensagens de entrada ou saída pendentes.
HRESULT FlushQueues(
ULONG_PTR ulUIParam,
ULONG cbTargetTransport,
LPENTRYID lpTargetTransport,
ULONG ulFlags
);
Parâmetros
ulUIParam
[in] Um identificador para a janela pai de qualquer caixa de diálogo ou janelas que este método exibe.
cbTargetTransport
[in] Reservados; deve ser zero.
lpTargetTransport
[in] Reservados; deve ser NULL.
ulFlags
[in] Um bitmask de sinalizadores que controla como a liberação da fila de mensagens é realizada. Os seguintes sinalizadores podem ser definidos:
FLUSH_DOWNLOAD
A fila ou filas de mensagem de entrada deve ser liberada.
FLUSH_FORCE
O provedor de transporte deve processar essa solicitação, se possível, mesmo que isso seja demorado.
FLUSH_NO_UI
O provedor de transporte não deve exibir uma interface do usuário.
FLUSH_UPLOAD
A fila ou filas de mensagem de saída deve ser liberada.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
O spooler MAPI chama o método IXPLogon::FlushQueues para aconselhar o provedor de transporte de que o spooler MAPI está prestes a começar a processar mensagens. O provedor de transporte deve chamar o método IMAPISupport::ModifiStatusRow para definir um bit apropriado para seu estado na propriedade PR_STATUS_CODE (PidTagStatusCode) de sua linha status. Depois de atualizar sua linha status, o provedor de transporte deve retornar S_OK para a chamada FlushQueues. O spooler MAPI então começa a enviar mensagens, com a operação sendo síncrona para o spooler MAPI.
Para dar suporte à implementação do método IMAPIStatus::FlushQueues , o spooler MAPI chama IXPLogon::FlushQueues para todos os objetos de logon para provedores de transporte ativos que estão em execução em uma sessão de perfil. Quando o método FlushQueues de um provedor de transporte é chamado como resultado de uma chamada de aplicativo cliente para IMAPIStatus::FlushQueues, o processamento de mensagens ocorre de forma assíncrona para o cliente.