MAPIDELETEMAIL-Rückruffunktion (mapi.h)

[Die Verwendung dieser Funktion wird abgeraten. Sie kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein.]

Die MAPIDeleteMail-Funktion löscht eine Nachricht.

Syntax

MAPIDELETEMAIL Mapideletemail;

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

Parameter

[in] lhSession

Sitzungshandle, das eine gültige Einfache MAPI-Sitzung darstellt. Der Wert des lhSession-Parameters muss eine gültige Sitzung darstellen. sie darf nicht 0 (null) sein.

[in] ulUIParam

Ziehpunkt des übergeordneten Fensters oder null, was angibt, dass es sich bei der Anzeige eines Dialogfelds um eine modale Anwendung handelt. Wenn der ulUIParam-Parameter ein übergeordnetes Fensterhandle enthält, ist er vom Typ HWND (in eine ULONG_PTR umgewandelt). Wenn während des Aufrufs kein Dialogfeld angezeigt wird, wird ulUIParam ignoriert.

[in] lpszMessageID

Der Bezeichner für die zu löschende Nachricht. Dieser Bezeichner ist messagingsystemspezifisch und ungültig, wenn MAPIDeleteMail erfolgreich zurückgibt.

flFlags

Reserviert; muss null sein.

ulReserved

Reserviert; muss null sein.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
MAPI_E_FAILURE	Mindestens ein nicht angegebener Fehler ist beim Löschen der Nachricht aufgetreten. Es wurde keine Nachricht gelöscht.
MAPI_E_INSUFFICIENT_MEMORY	Es war nicht genügend Arbeitsspeicher vorhanden, um fortzufahren. Es wurde keine Nachricht gelöscht.
MAPI_E_INVALID_MESSAGE	Im LpszMessageID-Parameter wurde ein ungültiger Nachrichtenbezeichner übergeben. Es wurde keine Nachricht gelöscht.
MAPI_E_INVALID_SESSION	Im lhSession-Parameter wurde ein ungültiges Sitzungshandle übergeben. Es wurde keine Nachricht gelöscht.
SUCCESS_SUCCESS	Der Aufruf war erfolgreich, und die Nachricht wurde gelöscht.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	mapi.h

Weitere Informationen

MAPIFindWeiter

MAPILogon

MAPISaveMail

Einfache MAPI