IMAPIFormMgr::OpenFormContainer

適用対象: Outlook 2013 | Outlook 2016

特定のフォーム コンテナーの IMAPIFormContainer インターフェイスを開きます。

HRESULT OpenFormContainer(
  HFRMREG hfrmreg,
  LPUNKNOWN lpunk,
  LPMAPIFORMCONTAINER FAR * lppfcnt
);

パラメーター

hfrmreg

[in]開くフォーム ライブラリ (つまり、開くフォーム コンテナー) を示す HFRMREG 列挙体。 HFRMREG 列挙型は、フォーム ライブラリ プロバイダーに固有の列挙型です。 使用できる HFRMREG 値は次のとおりです。

HFRMREG_DEFAULT

便利なフォーム コンテナー。

HFRMREG_FOLDER

フォルダー コンテナー。

HFRMREG_PERSONAL

既定のメッセージ ストアのコンテナー。

HFRMREG_LOCAL

ローカル フォーム コンテナー。

lpunk

[in]インターフェイスを開くオブジェクトへのポインター。 hfrmreg パラメーターの値にオブジェクト ポインターが必要な場合を除き、lpunk パラメーターは null にする必要があります。

lppfcnt

[out]返されるフォーム コンテナー オブジェクトへのポインターへのポインター。

戻り値

S_OK

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

MAPI_E_NO_INTERFACE

lpunk が指すオブジェクトは、必要なインターフェイスをサポートしていません。

注釈

フォーム ビューアーは 、IMAPIFormMgr::OpenFormContainer メソッドを呼び出して、特定のフォーム コンテナーの IMAPIFormContainer インターフェイスを開きます。 このインターフェイスは、フォームをフォーム コンテナーにインストールし、フォーム コンテナーからフォームを削除するために使用できます。

呼び出し側への注意

hfrmreg の値がHFRMREG_FOLDERされている場合、lpunk で使用されるインターフェイス識別子は null 以外であり、IMAPIFolder インターフェイスへの IUnknown::QueryInterface メソッド呼び出しを許可する必要があります。

ローカル フォーム コンテナーを開くには、 OpenFormContainer メソッドまたは MAPIOpenLocalFormContainer 関数の呼び出しを使用する必要があります。 IMAPIFormMgr::SelectFormContainer メソッドを使用して、ユーザーがローカル フォーム コンテナーを選択できるようにすることはできません。

MFCMAPI リファレンス

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

ファイル 関数 コメント
MainDlg.cpp
CMainDlg::OnOpenFormContainer
MFCMAPI では 、IMAPIFormMgr::OpenFormContainer メソッドを使用してフォーム コンテナーを取得し、コンテナーの内容をレンダリングできるようにします。
MsgStoreDlg.cpp
CMsgStoreDlg::OnOpenFormContainer
MFCMAPI では 、IMAPIFormMgr::OpenFormContainer メソッドを使用してフォルダーのフォーム コンテナーを取得し、コンテナーの内容をレンダリングできるようにします。

関連項目

IMAPIFormContainer::InstallForm

IMAPIFormMgr::SelectFormContainer

MAPIOpenLocalFormContainer

IMAPIFormMgr : IUnknown

[�R��h �T���v���Ƃ��� MFCMAPI