IMAPISession::ShowForm
適用対象: Outlook 2013 | Outlook 2016
フォームを表示します。
HRESULT ShowForm(
ULONG_PTR ulUIParam,
LPMDB lpMsgStore,
LPMAPIFOLDER lpParentFolder,
LPCIID lpInterface,
ULONG ulMessageToken,
LPMESSAGE lpMessageSent,
ULONG ulFlags,
ULONG ulMessageStatus,
ULONG ulMessageFlags,
ULONG ulAccess,
LPSTR lpszMessageClass
);
パラメーター
ulUIParam
[in]フォームの親ウィンドウへのハンドル。
lpMsgStore
[in] lpParentFolder パラメーターが指すフォルダーを含むメッセージ ストアへのポインター。
lpParentFolder
[in] ulMessageToken パラメーターに関連付けられたメッセージが作成されたフォルダーへのポインター。
lpInterface
[in]フォームに表示されるメッセージへのアクセスに使用するインターフェイスを表すインターフェイス識別子 (IID) へのポインター。 lpInterface パラメーターは NULL またはIID_IMessageにする必要があります。 NULL を渡すと、標準インターフェイス IMessage が使用されます。
ulMessageToken
[in]フォームに表示されるメッセージに関連付けられているトークン。 ulMessageToken パラメーターは、前の IMAPISession::P repareForm の呼び出しから lpulMessageToken パラメーターの内容に設定する必要があります。
lpMessageSent
[in]予約;は NULL である必要があります。
ulFlags
[in]メッセージの保存方法と保存方法を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_NEW_MESSAGE
メッセージは保存されていません (つまり、 IMAPIProp::SaveChanges メソッドは呼び出されていません)。
MAPI_POST_MESSAGE
メッセージは親フォルダーに保存する必要があります。 メッセージは送信用に処理されませんが、代わりにフォルダーに投稿されます。 このフラグが設定されていない場合、メッセージは送信トレイにコピーされ、送信のために処理されます。
ulMessageStatus
[in]ulMessageToken パラメーターのトークンに関連付けられているメッセージのPR_MSG_STATUS (PidTagMessageStatus) プロパティからコピーされたフラグのビットマスク。 フラグは、メッセージの状態に関する情報を提供します。
ulMessageFlags
[in]ulMessageToken パラメーターのトークンに関連付けられているメッセージのPR_MESSAGE_FLAGS (PidTagMessageFlags) プロパティからコピーされたフラグのビットマスク。 これらのフラグは、メッセージの状態に関する詳細情報を提供します。
ulAccess
[in]フォームに表示されるメッセージのアクセス許可レベルを示すフラグ。 この情報は、ulMessageToken パラメーターのトークンに関連付けられているメッセージのPR_ACCESS (PidTagAccess) プロパティからコピーされます。
lpszMessageClass
[in]ulMessageToken パラメーターのトークンに関連付けられているメッセージのPR_MESSAGE_CLASS (PidTagMessageClass) プロパティからコピーされた、フォームに表示されるメッセージのメッセージ クラスへのポインター。
戻り値
S_OK
フォームが正常に表示されました。
MAPI_E_USER_CANCEL
ユーザーは通常、ダイアログ ボックスの [キャンセル] ボタンをクリックして操作を 取り消 しました。
注釈
IMAPISession::ShowForm メソッドは、IMAPISession::P repareForm メソッドによって準備されたメッセージ フォームを表示します。
呼び出し側への注意
PrepareForm メソッドの lpMessage パラメーターで渡されるメッセージへの参照は 1 つだけです。
フォームの実装は、MAPI によって文書化されたもの以外のエラー値を返す可能性があることに注意してください。 これらのエラー値を使用して、エラー条件をより正確に判断できる場合は、それを行います。 それ以外の場合は、MAPI_E_CALL_FAILEDを処理するようにこれらのエラーを処理します。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MAPIFormFunctions.cpp |
OpenMessageModal |
MFCMAPI では、 IMAPISession::ShowForm メソッドと PrepareForm メソッドを使用して、モーダル フォームでメッセージを表示します。 |