Função de retorno de chamada MAPILOGOFF (mapi.h)

Artigo
03/09/2023

[O uso dessa função é desencorajado. Ele pode estar alterado ou indisponível nas versões subsequentes do Windows.]

A função MAPILogoff encerra uma sessão com o sistema de mensagens.

Sintaxe

MAPILOGOFF Mapilogoff;

ULONG Mapilogoff(
  [in] LHANDLE lhSession,
  [in] ULONG_PTR ulUIParam,
       FLAGS flFlags,
       ULONG ulReserved
)
{...}

Parâmetros

[in] lhSession

Manipule para que a sessão MAPI simples seja encerrada. Os identificadores de sessão são retornados pela função MAPILogon e invalidados por MAPILogoff. O valor do parâmetro lhSession deve representar uma sessão válida; não pode ser zero.

[in] ulUIParam

Identificador de janela pai ou zero, indicando que, se uma caixa de diálogo for exibida, ela será modal do aplicativo. Se o parâmetro ulUIParam contiver um identificador de janela pai, ele será do tipo HWND (convertido em um ULONG_PTR). Se nenhuma caixa de diálogo for exibida durante a chamada, ulUIParam será ignorado.

flFlags

Reservados; deve ser zero.

ulReserved

Reservados; deve ser zero.

Valor retornado

Essa função retorna um dos valores a seguir.

Código de retorno	Descrição
MAPI_E_FAILURE	O parâmetro flFlags é inválido ou ocorreu um ou mais erros não especificados.
MAPI_E_INSUFFICIENT_MEMORY	Não havia memória suficiente para continuar. A sessão não foi encerrada.
MAPI_E_INVALID_SESSION	Um identificador de sessão inválido foi usado para o parâmetro lhSession . A sessão não foi encerrada.
SUCCESS_SUCCESS	A chamada foi bem-sucedida e a sessão foi encerrada.

Requisitos


Plataforma de Destino	Windows
Cabeçalho	mapi.h

Confira também

MAPILogon

MAPI simples

Compartilhar via