IMAPIFormMgr::SelectFormIMAPIFormMgr::SelectForm

適用されます: OutlookApplies to: Outlook

、フォームを選択するユーザーを有効にする] ダイアログ ボックスを表示し、そのフォームを記述するフォームの情報オブジェクトを返します。Presents a dialog box that enables the user to select a form, and returns a form information object that describes that form.

HRESULT SelectForm(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPCSTR pszTitle,
  LPMAPIFOLDER pfld,
  LPMAPIFORMINFO FAR * ppfrminfoReturned
);

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 supplies a default caption.

pfldpfld

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

ppfrminfoReturnedppfrminfoReturned

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

�߂�lReturn value

S_OKS_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��BThe call succeeded and has 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::SelectForm最初の存在するフォームを選択するユーザーを有効にする] ダイアログ ボックスと、選択したフォームを説明する情報のフォーム オブジェクトを取得するために、します。Form viewers call the IMAPIFormMgr::SelectForm method to first present a dialog box that enables the user to select a form and then to retrieve a form information object that describes the selected form. ダイアログ ボックスには、1 つのフォームを選択するのにはユーザーが制限されます。The dialog box constrains the user to select a single form.

呼び出し側への注意Notes to callers

SelectForm ] ダイアログ ボックスには、隠されていないフォームのみが表示されます (つまり、非表示のプロパティを持つフォームをオフに)。The SelectForm dialog box displays only forms that are not hidden (that is, forms that have their hidden properties clear). _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.

MFCMAPI 参照MFCMAPI reference

MFCMAPI �T���v�� �R�[�h�ł́A���̕\��Q�Ƃ��Ă��������BFor MFCMAPI sample code, see the following table.

�t�@�C��File �֐�Function �R�����gComment
FolderDlg.cppFolderDlg.cpp
CFolderDlg::OnSelectFormCFolderDlg::OnSelectForm
MFCMAPI では、 IMAPIFormMgr::SelectFormメソッドを使用して、フォームを選択し、フォームに関する情報を 1 つまたは複数のログに送信します。MFCMAPI uses the IMAPIFormMgr::SelectForm method to select a form and send information about the form to one or more logs.

関連項目See also

IMAPIFormMgr: IUnknownIMAPIFormMgr : IUnknown

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample