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

Artigo
02/28/2024

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

A função MAPIDeleteMail exclui uma mensagem.

Sintaxe

MAPIDELETEMAIL Mapideletemail;

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

Parâmetros

[in] lhSession

Identificador de sessão que representa uma sessão MAPI simples válida. 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.

[in] lpszMessageID

O identificador da mensagem a ser excluída. Esse identificador é específico do sistema de mensagens e será inválido quando MAPIDeleteMail retornar com êxito.

flFlags

Reservados; deve ser zero.

ulReserved

Reservados; deve ser zero.

Retornar valor

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

Código de retorno	Descrição
MAPI_E_FAILURE	Ocorreu um ou mais erros não especificados ao excluir a mensagem. Nenhuma mensagem foi excluída.
MAPI_E_INSUFFICIENT_MEMORY	Não havia memória suficiente para continuar. Nenhuma mensagem foi excluída.
MAPI_E_INVALID_MESSAGE	Um identificador de mensagem inválido foi passado no parâmetro lpszMessageID . Nenhuma mensagem foi excluída.
MAPI_E_INVALID_SESSION	Um identificador de sessão inválido foi passado no parâmetro lhSession . Nenhuma mensagem foi excluída.
SUCCESS_SUCCESS	A chamada foi bem-sucedida e a mensagem foi excluída.