Win32 API 日本語リファレンス
ホーム › System.Mapi › LPMAPIDELETEMAIL

LPMAPIDELETEMAIL

コールバック

シグネチャ

DWORD LPMAPIDELETEMAIL(
    UINT_PTR lhSession,
    UINT_PTR ulUIParam,
    LPSTR lpszMessageID,
    DWORD flFlags,
    DWORD ulReserved
);

パラメーター

フィールド型説明
lhSessionUINT_PTR有効な Simple MAPI セッションを表すセッションハンドルです。lhSession パラメーターの値は有効なセッションを表す必要があり、0 にすることはできません。
ulUIParamUINT_PTR親ウィンドウのハンドル、または 0 です。0 の場合、ダイアログボックスが表示されるときはアプリケーションモーダルになります。ulUIParam パラメーターに親ウィンドウのハンドルを格納する場合、その型は HWND です (ULONG_PTR にキャストします)。呼び出し中にダイアログボックスが表示されない場合、 ulUIParam は無視されます。
lpszMessageIDLPSTR削除するメッセージの識別子です。この識別子はメッセージングシステム固有であり、MAPIDeleteMail が正常に戻った時点で無効になります。
flFlagsDWORD予約済みです。0 を指定する必要があります。
ulReservedDWORD予約済みです。0 を指定する必要があります。

公式ドキュメント

[この関数の使用は推奨されません。以降のバージョンの Windows では変更されるか、利用できなくなる可能性があります。]

MAPIDeleteMail 関数は、メッセージを削除します。

戻り値

この関数は、次のいずれかの値を返します。

戻り値 説明
MAPI_E_FAILURE
メッセージの削除中に、原因が特定されない 1 つ以上のエラーが発生しました。メッセージは削除されませんでした。
MAPI_E_INSUFFICIENT_MEMORY
処理を続行するのに十分なメモリーがありませんでした。メッセージは削除されませんでした。
MAPI_E_INVALID_MESSAGE
無効なメッセージ識別子が lpszMessageID パラメーターに渡されました。メッセージは削除されませんでした。
MAPI_E_INVALID_SESSION
無効なセッションハンドルが lhSession パラメーターに渡されました。メッセージは削除されませんでした。
SUCCESS_SUCCESS
呼び出しは成功し、メッセージが削除されました。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)