mapi.h) mapi.h (MAPIDELETEMAIL 回呼函式

[不建議使用此函式。在後續版本的 Windows 中，可能會變更或無法使用。

MAPIDeleteMail 函式會刪除訊息。

語法

MAPIDELETEMAIL Mapideletemail;

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

參數

[in] lhSession

代表有效 Simple MAPI 會話的會話句柄。 lhSession 參數的值必須代表有效的會話;不能為零。

[in] ulUIParam

父視窗句柄或零，表示如果顯示對話框，則為應用程式強制回應。如果 ulUIParam 參數包含父視窗句柄，則其類型為 HWND (轉換成ULONG_PTR) 。如果在呼叫期間未顯示任何對話框， 則會忽略 ulUIParam 。

[in] lpszMessageID

要刪除之訊息的標識碼。此標識碼是傳訊系統特定的，當 MAPIDeleteMail 成功傳回時，將會無效。

flFlags

保留;必須是零。

ulReserved

保留;必須是零。

傳回值

此函式會傳回下列其中一個值。

傳回碼	Description
MAPI_E_FAILURE	刪除訊息時發生一或多個未指定的錯誤。未刪除任何訊息。
MAPI_E_INSUFFICIENT_MEMORY	記憶體不足，無法繼續。未刪除任何訊息。
MAPI_E_INVALID_MESSAGE	lpszMessageID 參數中傳遞了無效的訊息標識碼。未刪除任何訊息。
MAPI_E_INVALID_SESSION	在 lhSession 參數中傳遞無效的會話句柄。未刪除任何訊息。
SUCCESS_SUCCESS	呼叫成功且訊息已刪除。