[この関数の使用はお勧めしません。 それ以降のバージョンの Windows では、変更または使用できない場合があります。
MAPIDeleteMail 関数は、メッセージを削除します。
構文
MAPIDELETEMAIL Mapideletemail;
ULONG Mapideletemail(
[in] LHANDLE lhSession,
[in] ULONG_PTR ulUIParam,
[in] LPSTR lpszMessageID,
FLAGS flFlags,
ULONG ulReserved
)
{...}
パラメーター
[in] lhSession
有効な簡易 MAPI セッションを表すセッション ハンドル。 lhSession パラメーターの値は、有効なセッションを表す必要があります。0 にすることはできません。
[in] ulUIParam
親ウィンドウ ハンドルまたは 0。ダイアログ ボックスが表示されている場合は、それがアプリケーション モーダルであることを示します。 ulUIParam パラメーターに親ウィンドウ ハンドルが含まれている場合は、HWND 型です (ULONG_PTRにキャストされます)。 呼び出し中にダイアログ ボックスが表示されない場合、 ulUIParam は無視されます。
[in] lpszMessageID
削除するメッセージの識別子。 この識別子はメッセージング システム固有であり、 MAPIDeleteMail が正常に返されると無効になります。
flFlags
予約;は 0 である必要があります。
ulReserved
予約;は 0 である必要があります。
戻り値
この関数は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
メッセージの削除中に、1 つ以上の未指定のエラーが発生しました。 メッセージが削除されませんでした。 |
|
続行するメモリが不足していました。 メッセージが削除されませんでした。 |
|
lpszMessageID パラメーターに無効なメッセージ識別子が渡されました。 メッセージが削除されませんでした。 |
|
lhSession パラメーターに無効なセッション ハンドルが渡されました。 メッセージが削除されませんでした。 |
|
呼び出しが成功し、メッセージが削除されました。 |
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | mapi.h |