IMAPIFormMgr::LoadForm

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

フォームを開始して既存のメッセージを開きます。

HRESULT LoadForm(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPCSTR lpszMessageClass,
  ULONG ulMessageStatus,
  ULONG ulMessageFlags,
  LPMAPIFOLDER pFolderFocus,
  LPMAPIMESSAGESITE pMessageSite,
  LPMESSAGE pmsg,
  LPMAPIVIEWCONTEXT pViewContext,
  REFIID riid,
  LPVOID FAR * ppvObj
);

パラメーター

ulUIParam

[in]フォームを開いている間に表示される進行状況インジケーターの親ウィンドウへのハンドル。 ulUIParam パラメーターは、ulFlags パラメーターにMAPI_DIALOG フラグが設定されていない限り無視されます。

ulFlags

[in]フォームの開き方を制御するフラグのビットマスク。 次のフラグを設定できます。

MAPI_DIALOG

ユーザー インターフェイスを表示して状態を指定するか、ユーザーに詳細を求めます。 このフラグが設定されていない場合、ユーザー インターフェイスは表示されません。

MAPIFORM_EXACTMATCH

完全に一致するメッセージ クラス文字列のみを解決する必要があります。

lpszMessageClass

[in]読み込むメッセージのメッセージ クラスに名前を付ける文字列へのポインター。 lpszMessageClass パラメーターに NULL が渡された場合、メッセージ クラスは pmsg パラメーターによって指されるメッセージから決定されます。

ulMessageStatus

[in]メッセージの状態に関する情報を提供するメッセージの PR_MSG_STATUS (PidTagMessageStatus) プロパティからコピーされたクライアント定義またはプロバイダー定義のフラグのビットマスク。 lpszMessageClass が NULL 以外の場合は、ulMessageStatus パラメーターを設定する必要があります。それ以外の場合、ulMessageStatus は無視されます。

ulMessageFlags

[in]メッセージの現在の状態を示すメッセージの PR_MESSAGE_FLAGS (PidTagMessageFlags) プロパティからコピーされたフラグのビットマスクへのポインター。 lpszMessageClass が NULL 以外の場合は、ulMessageFlags パラメーターを設定する必要があります。それ以外の場合、ulMessageFlags は無視されます。

pFolderFocus

[in]メッセージを直接含むフォルダーへのポインター。 このようなフォルダーが存在しない場合 (たとえば、メッセージが別のメッセージに埋め込まれている場合)、 pFolderFocus パラメーターは NULL にすることができます。

pMessageSite

[in]メッセージのメッセージ サイトへのポインター。

Pmsg

[in]メッセージへのポインター。

pViewContext

[in]メッセージのビュー コンテキストへのポインター。 pViewContext パラメーターには NULL を指定できます。

Riid

[in]返されるフォーム オブジェクトに使用するインターフェイスのインターフェイス識別子 (IID)。 riid パラメーターは NULL にすることはできません。

Ppvobj

[out]返されたインターフェイスへのポインターへのポインター。

戻り値

S_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B

MAPI_E_NO_INTERFACE

フォームは、要求されたインターフェイスをサポートしていません。

MAPI_E_NOT_FOUND

lpszMessageClass で渡されたメッセージ クラスが、フォーム ライブラリ内のフォームのメッセージ クラスと一致しません。

注釈

フォーム ビューアーは IMAPIFormMgr::LoadForm メソッドを呼び出して、既存のメッセージのフォームを開きます。 LoadForm はフォーム オブジェクトを開き、メッセージをフォーム オブジェクトに読み込み、必要に応じて適切なビュー コンテキストを設定し、フォーム オブジェクトの要求されたインターフェイスを返します。

pFolderFocus パラメーターは、メッセージを含むフォルダーを指します。 メッセージが別のメッセージに埋め込まれている場合、 pFolderFocus は NULL にする必要があります。

実装に関するメモ

lpszMessageClass で NULL が渡された場合、実装はメッセージのPR_MESSAGE_CLASS (PidTagMessageClass)、PR_MSG_STATUS、および PR_MESSAGE_FLAGS プロパティからメッセージのメッセージ クラス、状態、フラグを取得します。 lpszMessageClass にメッセージ クラス文字列が指定されている場合、実装では ulMessageStatus と ulMessageFlags の値を使用する必要があります。

MFCMAPI リファレンス

MFCMAPI のサンプル コードについては、次の表を参照してください。

ファイル 関数 コメント
MAPIFormFunctions.cpp
 OpenMessageNonModal
 MFCMAPI では、 IMAPIFormMgr::LoadForm メソッドを使用してフォームを表示する前にフォームを読み込みます。

関連項目

PidTagMessageClass 標準プロパティ
PidTagMessageFlags 標準プロパティ
PidTagMessageStatus 標準プロパティ
IMAPIFormMgr: コードサンプルとしての IUnknown MFCMAPI