IMAPIFormContainer::ResolveMultipleMessageClasses
適用対象: Outlook 2013 | Outlook 2016
メッセージ クラスのグループをフォーム コンテナー内のフォームに解決し、それらのフォームのフォーム情報オブジェクトの配列を返します。
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClassArray,
ULONG ulFlags,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
パラメーター
pMsgClassArray
[in]解決するメッセージ クラスの名前を含む配列へのポインター。 メッセージ クラス名は常に ANSI 文字列であり、Unicode ではありません。
ulFlags
[in]メッセージ クラスの解決方法を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPIFORM_EXACTMATCH
完全に一致するメッセージ クラス文字列のみを解決する必要があります。
ppfrminfoarray
[out]フォーム情報オブジェクトの配列へのポインターへのポインター。 クライアント アプリケーションが pMsgClassArray パラメーターで NULL を渡す場合、 ppfrminfoarray パラメーターには、コンテナー内のすべてのフォームのフォーム情報オブジェクトが含まれます。
戻り値
S_OK
�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B
注釈
クライアント アプリケーションは IMAPIFormContainer::ResolveMultipleMessageClasses メソッドを呼び出して、メッセージ クラスのグループをフォーム コンテナー内のフォームに解決します。 ppfrminfoarray パラメーターで返されるフォーム情報オブジェクトの配列は、フォームの各プロパティへのさらにアクセスを提供します。
呼び出し側への注意
メッセージ クラスのグループをフォームに解決するには、解決するメッセージ クラス名の配列を渡します。 解決を強制的に正確にするには (つまり、メッセージ クラスの基底クラスへの解決を防ぐために)、 ulFlags パラメーターに MAPIFORM_EXACTMATCH フラグを渡すことができます。
メッセージ クラスをフォームに解決できない場合、フォーム情報配列内のそのメッセージ クラスに対して NULL が返されます。 したがって、メソッドがS_OKを返した場合でも、すべてのメッセージ クラスが正常に解決されたとは想定しないでください。 代わりに、返された配列内の値をチェックします。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| FormContainerDlg.cpp |
CFormContainerDlg::OnResolveMultipleMessageClasses |
MFCMAPI では、 IMAPIFormContainer::ResolveMultipleMessageClasses メソッドを使用して、一連のメッセージ クラスに関連付けられているフォームを見つけます。 |