IMAPISupport::SpoolerYield
Aplica-se a: Outlook 2013 | Outlook 2016
Fornece o controle da CPU ao spooler MAPI para que ele possa executar todas as tarefas que considerar necessárias.
HRESULT SpoolerYield(
ULONG ulFlags
);
Parâmetros
ulFlags
Reservados; deve ser zero.
Valor de retorno
S_OK
O provedor de transporte lançou com êxito a CPU.
MAPI_W_CANCEL_MESSAGE
Instrui o provedor de transporte a interromper a entrega da mensagem a todos os destinatários que ainda não a receberam.
Comentários
O método IMAPISupport::SpoolerYield é implementado para objetos de suporte do provedor de transporte. Os provedores de transporte chamam spoolerYield para permitir que o spooler MAPI realize qualquer processamento necessário.
Notas para chamadores
Chame SpoolerYield quando estiver executando operações longas que podem ser pausadas. Isso permite que aplicativos em primeiro plano sejam executados durante uma operação longa, como a entrega em uma grande lista de destinatários em uma rede ocupada.
Se SpoolerYield retornar com MAPI_W_CANCEL_MESSAGE, o spooler MAPI determinou que a mensagem não deve mais ser enviada. Retorne MAPI_E_USER_CANCEL ao processo de chamada e saia, se possível.
Para obter mais informações sobre como renderizar ao spooler MAPI, confira Interagindo com o Spooler MAPI.