IMAPIFormMgr::CreateForm
適用対象: Outlook 2013 | Outlook 2016
フォームを開き、フォームのメッセージ クラスに基づいて新しいメッセージを作成します。
HRESULT CreateForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
IMAPIFormInfo pfrminfoToActivate,
REFIID refiidToAsk,
LPVOID FAR * ppvObj
);
パラメーター
ulUIParam
[in]フォームを開いている間に表示される進行状況インジケーターの親ウィンドウへのハンドル。 ulUIParam パラメーターは、ulFlags パラメーターにMAPI_DIALOG フラグが設定されていない限り無視されます。
ulFlags
[in]フォームの開き方を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_DIALOG
ユーザー インターフェイスを表示して状態を指定するか、ユーザーに詳細を求めます。 このフラグが設定されていない場合、ユーザー インターフェイスは表示されません。
pfrminfoToActivate
[in]フォームを開くために使用されるフォーム情報オブジェクトへのポインター。
refiidToAsk
[in]作成されたフォーム オブジェクトに対して返されるインターフェイスのインターフェイス識別子 (IID) へのポインター。 refiidToAsk パラメーターは NULL にすることはできません。
Ppvobj
[out]返されたインターフェイスへのポインターへのポインター。
戻り値
S_OK
�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B
MAPI_E_NO_INTERFACE
要求されたインターフェイスは、フォーム オブジェクトではサポートされていません。
注釈
フォーム ビューアーは IMAPIFormMgr::CreateForm メソッドを呼び出してフォームを開き、フォームのメッセージ クラスに基づいて新しいメッセージを作成します。 CreateForm は、指定されたフォーム情報オブジェクトで説明されているように、そのフォームのフォーム サーバーのインスタンスを作成してフォームを開きます。 必要に応じて、 CreateForm は IMAPIFormMgr::P repareForm メソッドを呼び出して、フォーム サーバー コードをユーザーのディスクにダウンロードします。
pfrminfoToActivate パラメーターは、正しく解決されたフォーム情報オブジェクトを指している必要があります。
フォームを開いた後、呼び出し元のフォーム ビューアーは IPersistMessage インターフェイスを使用してメッセージを設定する必要があり、必要に応じてフォームのビュー コンテキストを設定できます。 詳細については、「 フォーム サーバーの起動」を参照してください。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
MFCMAPI では、 IMAPIFormMgr::CreateForm メソッドを使用してフォームを表示する前にフォームを作成します。 |