IMAPIFormMgr::SelectMultipleForms
適用対象: Outlook 2013 | Outlook 2016
ユーザーが複数のフォームを選択できるようにするダイアログ ボックスを表示し、それらのフォームを記述するフォーム情報オブジェクトの配列を返します。
HRESULT SelectMultipleForms(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFOARRAY pfrminfoarray,
LPMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
パラメーター
ulUIParam
[in]表示されるダイアログ ボックスの親ウィンドウへのハンドル。
ulFlags
[in]渡された文字列の型を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_UNICODE
渡された文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式です。
pszTitle
[in]ダイアログ ボックスのキャプションを含む文字列へのポインター。 pszTitle パラメーターが NULL の場合、フォームを提供するフォーム ライブラリ プロバイダーは既定のキャプションを提供します。
pfld
[in]フォームを選択するフォルダーへのポインター。 pfld パラメーターが NULL の場合、フォームはローカル、個人用、またはorganizationフォーム コンテナーから選択されます。
pfrminfoarray
[in]ユーザーに事前に選択されているフォーム情報オブジェクトの配列へのポインター。
ppfrminfoarray
[out]フォーム情報オブジェクトの返される配列へのポインターへのポインター。
戻り値
S_OK
呼び出しは成功し、期待される値または値を返しました。
MAPI_E_BAD_CHARWIDTH
MAPI_UNICODE フラグが設定され、実装で Unicode がサポートされていないか、MAPI_UNICODEが設定されておらず、実装で Unicode のみがサポートされています。
MAPI_E_USER_CANCEL
ユーザーは通常、ダイアログ ボックスの [キャンセル] ボタンをクリックして操作を キャンセル しました。
注釈
フォーム ビューアーは IMAPIFormMgr::SelectMultipleForms メソッドを呼び出して、ユーザーが複数のフォームを選択し、選択したフォームを記述するフォーム情報オブジェクトの配列を取得できるようにするダイアログ ボックスを最初に表示します。 [SelectMultipleForms]\(SelectMultipleForms\) ダイアログ ボックスには、すべてのフォームが非表示かどうか (つまり、非表示のプロパティがクリアされているかどうか) が表示されます。
実装に関するメモ
フォーム ビューアーが ulFlags パラメーターで MAPI_UNICODE フラグを渡す場合、すべての文字列は Unicode です。 Unicode 文字列をサポートしていないフォーム ライブラリ プロバイダーは、MAPI_UNICODEが渡された場合にMAPI_E_BAD_CHARWIDTHを返す必要があります。