IMAPIFormMgr::SelectMultipleFormsIMAPIFormMgr::SelectMultipleForms

適用されます: OutlookApplies to: Outlook

複数のフォームを選択するユーザーを有効にする] ダイアログ ボックスを表示し、それらのフォームを記述するオブジェクトの情報、フォームの配列を返します。Presents a dialog box that enables the user to select multiple forms, and returns an array of form information objects that describe those forms.

HRESULT SelectMultipleForms(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPCSTR pszTitle,
  LPMAPIFOLDER pfld,
  LPMAPIFORMINFOARRAY pfrminfoarray,
  LPMAPIFORMINFOARRAY FAR * ppfrminfoarray
);

ParametersParameters

ulUIParamulUIParam

[in]表示されたダイアログ ボックスの親ウィンドウへのハンドル。[in] A handle to the parent window of the displayed dialog box.

ulFlagsulFlags

[in]渡された文字列の種類を制御するフラグのビットマスクです。[in] A bitmask of flags that controls the type of the passed-in strings. 次のフラグを設定することができます。The following flag can be set:

MAPI_UNICODEMAPI_UNICODE

渡された文字列は、Unicode 形式では。The passed-in strings are in Unicode format. MAPI_UNICODE フラグが設定されていない場合は、ANSI 形式の文字列です。If the MAPI_UNICODE flag is not set, the strings are in ANSI format.

pszTitlepszTitle

[in]ダイアログ ボックスのキャプションを含む文字列へのポインター。[in] A pointer to a string that contains the caption of the dialog box. _PszTitle_パラメーターが NULL の場合は、フォームを提供するフォーム ライブラリ プロバイダーは、既定のキャプションを提供します。If the pszTitle parameter is NULL, the form library provider that provides the forms supplies a default caption.

pfldpfld

[in]フォームを選択するフォルダーへのポインター。[in] A pointer to the folder from which to select the forms. _Pfld_パラメーターが NULL の場合は、ローカル、個人、または組織フォームのコンテナーから、フォームが選択されます。If the pfld parameter is NULL, the forms are selected from the local, personal, or organization form container.

pfrminfoarraypfrminfoarray

[in]ユーザーに事前に選択されているフォーム情報オブジェクトの配列へのポインター。[in] A pointer to an array of form information objects that are preselected for the user.

ppfrminfoarrayppfrminfoarray

[out]フォーム情報オブジェクトの返される配列へのポインターへのポインター。[out] A pointer to a pointer to the returned array of form information objects.

�߂�lReturn value

S_OKS_OK

呼び出しが成功し、予期される値または値が返されます。The call succeeded and returned the expected value or values.

MAPI_E_BAD_CHARWIDTHMAPI_E_BAD_CHARWIDTH

か、MAPI_UNICODE フラグが設定された実装は Unicode をサポートしていないまたは MAPI_UNICODE が設定されていませんでしたし、実装は、Unicode だけをサポートしています。Either the MAPI_UNICODE flag was set and the implementation does not support Unicode, or MAPI_UNICODE was not set and the implementation supports only Unicode.

MAPI_E_USER_CANCELMAPI_E_USER_CANCEL

ユーザー操作がキャンセルされました、通常] ダイアログ ボックスで [キャンセル] ボタンをクリックするとします。The user canceled the operation, typically by clicking the Cancel button in the dialog box.

備考Remarks

フォーム ビューアー メソッドを呼び出して、 IMAPIFormMgr::SelectMultipleFormsを最初の存在により、ユーザーが複数のフォームを選択するダイアログ ボックスと、フォームの配列を取得するために情報オブジェクトを選択したフォームを記述します。Form viewers call the IMAPIFormMgr::SelectMultipleForms method to first present a dialog box that enables the user to select multiple forms and then to retrieve an array of form information objects that describe the selected forms. SelectMultipleForms ] ダイアログ ボックスでは、(つまり、かどうか、非表示のプロパティは、クリア) が非表示にするかどうか、すべてのフォームが表示されます。The SelectMultipleForms dialog box displays all forms, whether or not they are hidden (that is, whether or not their hidden properties are clear).

実装者へのメモNotes to implementers

_UlFlags_パラメーターで、フォームのビューアーが MAPI_UNICODE フラグを渡すと、すべての文字列は Unicode です。If a form viewer passes the MAPI_UNICODE flag in the ulFlags parameter, all strings are Unicode. Unicode 文字列をサポートしていないフォーム ライブラリ プロバイダーは、MAPI_UNICODE が渡された場合、MAPI_E_BAD_CHARWIDTH を返す必要があります。Form library providers that do not support Unicode strings should return MAPI_E_BAD_CHARWIDTH if MAPI_UNICODE is passed.

関連項目See also

IMAPIFormMgr: IUnknownIMAPIFormMgr : IUnknown