IMAPISession::PrepareForm
適用対象: Outlook 2013 | Outlook 2016
IMAPISession::ShowForm メソッドがメッセージにアクセスするために使用する数値トークンを作成します。
HRESULT PrepareForm(
LPCIID lpInterface,
LPMESSAGE lpMessage,
ULONG FAR * lpulMessageToken
);
パラメーター
lpInterface
[in]メッセージへのアクセスに使用するインターフェイスを表すインターフェイス識別子 (IID) へのポインター。 null を渡すと、標準インターフェイス (IMessage) が使用されます。 lpInterface パラメーターは null またはIID_IMessageにする必要があります。
lpMessage
[in]フォームに表示されるメッセージへのポインター。
lpulMessageToken
[out]メッセージ トークンへのポインター。これは、lpMessage が指すメッセージにアクセスするために IMAPISession::ShowForm メソッドによって使用されます。
戻り値
S_OK
フォームの準備は成功しました。
注釈
IMAPISession::P repareForm メソッドは、lpMessage パラメーターが指すメッセージのメッセージ トークンを作成し、メッセージの IUnknown::AddRef メソッドを呼び出します。 このトークンは 、ulMessageToken パラメーターで IMAPISession::ShowForm に渡されます。
呼び出し側への注意
PrepareForm の呼び出しが成功した場合は、ShowForm を呼び出す前に IUnknown::Release メソッドを呼び出して lpMessage が指すメッセージを解放します。 ShowForm を呼び出す前にメッセージを解放できないと、メモリ リークが発生する可能性があります。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MAPIFormFunctions.cpp |
OpenMessageModal |
MFCMAPI では、 IMAPISession::P repareForm メソッドと IMAPISession::ShowForm を使用して、モーダル 形式でメッセージを表示します。 |