IMAPIFormMgr::SelectForm
適用対象: Outlook 2013 | Outlook 2016
ユーザーがフォームを選択できるようにするダイアログ ボックスを表示し、そのフォームを説明するフォーム情報オブジェクトを返します。
HRESULT SelectForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFO FAR * ppfrminfoReturned
);
パラメーター
ulUIParam
[in]表示されるダイアログ ボックスの親ウィンドウへのハンドル。
ulFlags
[in]渡された文字列の型を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_UNICODE
渡された文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式です。
pszTitle
[in]ダイアログ ボックスのキャプションを含む文字列へのポインター。 pszTitle パラメーターが NULL の場合、フォーム ライブラリ プロバイダーは既定のキャプションを提供します。
pfld
[in]フォームを選択するフォルダーへのポインター。 pfld パラメーターが NULL の場合、フォームはローカル、個人用、またはorganizationフォーム コンテナーから選択できます。
ppfrminfoReturned
[out]返されたフォーム情報オブジェクトへのポインターへのポインター。
戻り値
S_OK
�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B
MAPI_E_BAD_CHARWIDTH
MAPI_UNICODE フラグが設定され、実装で Unicode がサポートされていないか、MAPI_UNICODEが設定されておらず、実装で Unicode のみがサポートされています。
MAPI_E_USER_CANCEL
ユーザーは通常、ダイアログ ボックスの [キャンセル] ボタンをクリックして操作を キャンセル しました。
注釈
フォーム ビューアーは IMAPIFormMgr::SelectForm メソッドを呼び出して、まずユーザーがフォームを選択し、選択したフォームを記述するフォーム情報オブジェクトを取得できるようにするダイアログ ボックスを表示します。 ダイアログ ボックスでは、ユーザーが 1 つのフォームを選択するように制限されます。
呼び出し側への注意
[SelectForm]\(フォームの選択\) ダイアログ ボックスには、非表示ではないフォーム (非表示のプロパティがクリアされているフォーム) のみが表示されます。 フォーム ビューアーが ulFlags パラメーターで MAPI_UNICODE フラグを渡す場合、すべての文字列は Unicode です。 Unicode 文字列をサポートしていないフォーム ライブラリ プロバイダーは、MAPI_UNICODEが渡された場合にMAPI_E_BAD_CHARWIDTHを返す必要があります。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| FolderDlg.cpp |
CFolderDlg::OnSelectForm |
MFCMAPI では 、IMAPIFormMgr::SelectForm メソッドを使用してフォームを選択し、フォームに関する情報を 1 つ以上のログに送信します。 |