Compartilhar via


CloseIMsgSession

Aplica-se a: Outlook 2013 | Outlook 2016

Fecha uma sessão de mensagem e todas as mensagens criadas nessa sessão.

Propriedade Valor
Arquivo de cabeçalho:
Imessage.h
Implementado por:
MAPI
Chamado por:
Aplicativos cliente e provedores de serviços
VOID CloseIMsgSession(
  LPMSGSESS lpMsgSess
);

Parâmetros

lpMsgSess

[in] Ponteiro para o objeto de sessão de mensagem obtido usando a função OpenIMsgSession no início da sessão de mensagem.

Valor de retorno

Nenhum.

Comentários

Uma sessão de mensagem é usada por aplicativos cliente e provedores de serviços que desejam lidar com vários objetos mapi IMessage relacionados criados em cima de objetos OLE IStorage subjacentes. O cliente ou provedor usa as funções OpenIMsgSession e CloseIMsgSession para encerrar a criação dessas mensagens dentro de uma sessão de mensagem. Depois que a sessão de mensagem é aberta, o cliente ou provedor passa um ponteiro para ele em uma chamada para OpenIMsgOnIStg para criar um novo objeto IMessage-on-IStorage.

Uma sessão de mensagem mantém o controle de todos os objetos IMessage-on-IStorage abertos durante a duração da sessão, além de todos os anexos e outras propriedades das mensagens. Quando um cliente ou provedor chama CloseIMsgSession, ele fecha todos esses objetos. Chamar CloseIMsgSession é a única maneira de fechar objetos IMessage-on-IStorage.