IMAPIFormMgr::ResolveMessageClass
適用対象: Outlook 2013 | Outlook 2016
メッセージ クラスをフォーム コンテナー内のフォームに解決し、そのフォームのフォーム情報オブジェクトを返します。
HRESULT ResolveMessageClass(
LPCSTR szMsgClass,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPMAPIFORMINFO FAR * ppResult
);
パラメーター
szMsgClass
[in]解決されるメッセージ クラスに名前を付ける文字列。
ulFlags
[in]メッセージ クラスの解決方法を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPIFORM_EXACTMATCH
完全に一致するメッセージ クラス文字列のみを解決する必要があります。
pFolderFocus
[in]解決されるメッセージを含むフォルダーへのポインター。 pFolderFocus パラメーターには NULL を指定できます。
ppResult
[out]返されるフォーム情報オブジェクトへのポインターへのポインター。
戻り値
S_OK
�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B
MAPI_E_NOT_FOUND
szMsgClass パラメーターで渡されるメッセージ クラスが、フォーム ライブラリ内のフォームのメッセージ クラスと一致しません。
注釈
フォーム ビューアーは IMAPIFormMgr::ResolveMessageClass メソッドを呼び出して、メッセージ クラスをフォーム コンテナー内のフォームに解決します。 ppResult パラメーターで返されるフォーム情報オブジェクトは、指定されたメッセージ クラスを持つフォームのプロパティにさらにアクセスできます。
呼び出し側への注意
メッセージ クラスをフォームに解決するには、フォーム ビューアーが解決するメッセージ クラスの名前 (" など) を IPM.HelpDesk.Software渡します。 解決を強制的に正確にする (つまり、完全に一致するフォーム サーバーが使用できないときにメッセージ クラスの基底クラスに解決されないようにするため) には、 ulFlags パラメーターでMAPIFORM_EXACTMATCH フラグを渡すことができます。 pFolderFocus パラメーターが NULL の場合、メッセージ クラス解決プロセスではフォルダー コンテナーは検索されません。
検索されるコンテナーの順序は、フォーム ライブラリ プロバイダーの実装によって異なります。 既定のフォーム ライブラリ プロバイダーは、最初にローカル コンテナー、次に、渡されたフォルダーのフォルダー コンテナー、個人用フォーム コンテナー、最後に organization コンテナーを検索します。
メッセージ クラス名は常に ANSI 文字列であり、Unicode ではありません。
解決されたメッセージ クラスのクラス識別子は、フォーム情報オブジェクトの一部として返されます。 フォーム ビューアーは、フォーム ビューアーが IMAPIFormMgr::P repareForm メソッドまたは IMAPIFormMgr::CreateForm メソッドを呼び出すまで、クラス識別子が OLE ライブラリに存在することを前提として動作しません。