IMAPIFormContainer::ResolveMultipleMessageClassesIMAPIFormContainer::ResolveMultipleMessageClasses

適用されます: OutlookApplies to: Outlook

フォームのコンテナー内のフォームにメッセージ クラスのグループを解決し、それらのフォームのオブジェクトの情報、フォームの配列を返します。Resolves a group of message classes to their forms in a form container and returns an array of form information objects for those forms.

HRESULT ResolveMultipleMessageClasses(
  LPSMESSAGECLASSARRAY pMsgClassArray,
  ULONG ulFlags,
  LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);

ParametersParameters

pMsgClassArraypMsgClassArray

[in]解決するのにはメッセージ クラスの名前を格納している配列へのポインター。[in] A pointer to an array that contains the names of the message classes to resolve. メッセージ クラス名は、常に ANSI 文字列を Unicode ではないです。Message class names are always ANSI strings, never Unicode.

ulFlagsulFlags

[in]メッセージ クラスを解決する方法を制御するフラグのビットマスクです。[in] A bitmask of flags that controls how the message classes are resolved. 次のフラグを設定することができます。The following flag can be set:

MAPIFORM_EXACTMATCHMAPIFORM_EXACTMATCH

完全に一致するメッセージ クラス文字列のみを解決する必要があります。Only message class strings that are an exact match should be resolved.

ppfrminfoarrayppfrminfoarray

[out]フォーム情報オブジェクトの配列へのポインターへのポインター。[out] A pointer to a pointer to an array of form information objects. 場合は、クライアント アプリケーションは、 _pMsgClassArray_パラメーターに NULL を渡す、 _ppfrminfoarray_パラメーターには、フォームのコンテナー内のすべてのフォーム オブジェクト情報にはが含まれています。If a client application passes NULL in the pMsgClassArray parameter, the ppfrminfoarray parameter contains form information objects for all forms in the container.

�߂�lReturn value

S_OKS_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��BThe call succeeded and has returned the expected value or values.

����Remarks

クライアント アプリケーションは、フォームのコンテナー内のフォームにメッセージ クラスのグループを解決するのにはIMAPIFormContainer::ResolveMultipleMessageClassesメソッドを呼び出します。Client applications call the IMAPIFormContainer::ResolveMultipleMessageClasses method to resolve a group of message classes to forms within a form container. フォーム、 _ppfrminfoarray_パラメーターで返されるオブジェクトの情報の配列の各フォームのプロパティへのアクセスをさらに提供します。The array of form information objects returned in the ppfrminfoarray parameter provides further access to each of the forms' properties.

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

メッセージ クラスのグループを解決するにはフォームに、解決するのにはメッセージ クラス名の配列を渡します。To resolve a group of message classes to forms, pass in an array of message class names to be resolved. 正確な解像度を強制的に (つまり、メッセージ クラスの基本クラスへの解像度を防ぐために)、 _ulFlags_パラメーターでは、MAPIFORM_EXACTMATCH フラグを渡すことができます。To force the resolution to be exact (that is, to prevent resolution to a base class of the message class), the MAPIFORM_EXACTMATCH flag can be passed in the ulFlags parameter.

フォームにメッセージ クラスを解決できない場合は、フォーム情報の配列では、そのメッセージ クラスの NULL が返されます。If a message class cannot be resolved to a form, NULL is returned for that message class in the form information array. したがって、場合でも、このメソッドは S_OK を返しますと仮定しないですべてのメッセージ クラスが正常に解決されていること。Therefore, even if the method returns S_OK, do not assume that all message classes have been successfully resolved. 代わりに、返される配列内の値をチェックします。Instead, check the values in the returned array.

MFCMAPI 参照MFCMAPI reference

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

�t�@�C��File �֐�Function �R�����gComment
FormContainerDlg.cppFormContainerDlg.cpp
CFormContainerDlg::OnResolveMultipleMessageClassesCFormContainerDlg::OnResolveMultipleMessageClasses
MFCMAPI では、 IMAPIFormContainer::ResolveMultipleMessageClassesメソッドを使用して、一連のメッセージ クラスに関連付けられているフォームを見つけます。MFCMAPI uses the IMAPIFormContainer::ResolveMultipleMessageClasses method to locate a form that is associated with a set of message classes.

関連項目See also

IMAPIFormContainer::ResolveMessageClassIMAPIFormContainer::ResolveMessageClass

IMAPIFormContainer: IUnknownIMAPIFormContainer : IUnknown

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