Fonction de rappel MAPIDELETEMAIL (mapi.h)

[L’utilisation de cette fonction est déconseillée. Il peut être modifié ou indisponible dans les versions ultérieures de Windows.]

La fonction MAPIDeleteMail supprime un message.

Syntaxe

MAPIDELETEMAIL Mapideletemail;

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

Paramètres

[in] lhSession

Handle de session qui représente une session MAPI simple valide. La valeur du paramètre lhSession doit représenter une session valide ; il ne peut pas être égal à zéro.

[in] ulUIParam

Poignée de fenêtre parente ou zéro, indiquant que si une boîte de dialogue s’affiche, il s’agit d’une application modale. Si le paramètre ulUIParam contient un handle de fenêtre parent, il est de type HWND (cast en ULONG_PTR). Si aucune boîte de dialogue n’est affichée pendant l’appel, ulUIParam est ignoré.

[in] lpszMessageID

Identificateur du message à supprimer. Cet identificateur est spécifique au système de messagerie et n’est pas valide lorsque MAPIDeleteMail est retourné avec succès.

flFlags

Réservés au; doit être égal à zéro.

ulReserved

Réservés au; doit être égal à zéro.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Code de retour	Description
MAPI_E_FAILURE	Une ou plusieurs erreurs non spécifiées se sont produites lors de la suppression du message. Aucun message n’a été supprimé.
MAPI_E_INSUFFICIENT_MEMORY	La mémoire était insuffisante pour continuer. Aucun message n’a été supprimé.
MAPI_E_INVALID_MESSAGE	Un identificateur de message non valide a été passé dans le paramètre lpszMessageID . Aucun message n’a été supprimé.
MAPI_E_INVALID_SESSION	Un handle de session non valide a été passé dans le paramètre lhSession . Aucun message n’a été supprimé.
SUCCESS_SUCCESS	L’appel a réussi et le message a été supprimé.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mapi.h

Voir aussi

MAPIFindNext

MAPILogon

MAPISaveMail

Simple MAPI