IXPLogon::TransportLogoff
Aplica-se a: Outlook 2013 | Outlook 2016
Inicia o processo de logoff.
HRESULT TransportLogoff(
ULONG ulFlags
);
Parâmetros
ulFlags
[in] Reservados; deve ser zero.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados. Se algo diferente de S_OK for retornado, o provedor será desativado.
Comentários
O spooler MAPI chama o método IXPLogon::TransportLogoff para encerrar uma sessão do provedor de transporte para um determinado usuário. Antes de chamar TransportLogoff, o spooler MAPI descarta qualquer dado sobre tipos de endereço de mensagens com suporte para esta sessão passados no método IXPLogon::AddressTypes .
Observações para implementadores
O provedor de transporte deve estar preparado para aceitar uma chamada para TransportLogoff a qualquer momento. Se uma mensagem estiver em processo, o provedor deverá interromper o processo de envio.
O provedor de transporte deve liberar todos os recursos alocados para sua sessão atual. Se ele tiver alocado qualquer memória para esta sessão com a função MAPIAllocateBuffer , ela deverá liberar a memória usando a função MAPIFreeBuffer . Qualquer memória alocada pelo provedor de transporte para atender chamadas ao método IXPLogon::AddressTypes pode ser liberada com segurança neste momento.
Normalmente, ao concluir uma chamada TransportLogoff , um provedor deve primeiro invalidar seu objeto logon chamando o método IMAPISupport::MakeInvalid e, em seguida, liberar seu objeto de suporte. A implementação do TransportLogoff pelo provedor deve liberar o objeto de suporte por último, pois quando o objeto de suporte é lançado, o spooler MAPI também pode liberar o objeto provedor em si.