IMAPIFormMgr::CalcFormPropSet
適用対象: Outlook 2013 | Outlook 2016
フォームのグループが使用するプロパティの配列を返します。
HRESULT CalcFormPropSet(
LPSMAPIFORMINFOARRAY pfrminfoarray,
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
パラメーター
pfrminfoarray
[in]プロパティを返すフォームを識別するフォーム情報オブジェクトの配列へのポインター。
ulFlags
[in] ppResults パラメーターのプロパティ配列の返し方を制御するフラグのビットマスク。 次のフラグを設定できます。
FORMPROPSET_INTERSECTION
返される配列には、フォームのプロパティの積集合が含まれています。
FORMPROPSET_UNION
返される配列には、フォームのプロパティの和集合が含まれています。
MAPI_UNICODE
配列で返される文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式です。
ppResults
[out]返された SMAPIFormPropArray 構造体へのポインター。この構造体には、フォームで使用されるプロパティが含まれます。
戻り値
S_OK
呼び出しは成功し、期待される値または値を返しました。
MAPI_E_BAD_CHARWIDTH
MAPI_UNICODE フラグが設定され、実装で Unicode がサポートされていないか、MAPI_UNICODEが設定されておらず、実装で Unicode のみがサポートされています。
注釈
フォーム ビューアーは IMAPIFormMgr::CalcFormPropSet メソッドを呼び出して、フォームのグループが使用するプロパティの配列を取得します。 CalcFormPropSet は 、ulFlags パラメーターに設定されたフラグに応じて、これらのフォームのプロパティ セットの積集合または和集合を受け取り、結果のプロパティ グループを含む SMAPIFormPropArray 構造体を返します。
実装に関するメモ
フォーム ビューアーが ulFlags パラメーターで MAPI_UNICODE フラグを渡す場合は、すべての文字列を Unicode 文字列として返す必要があります。 Unicode 文字列をサポートしていないフォーム ライブラリ プロバイダーは、MAPI_UNICODEが渡された場合にMAPI_E_BAD_CHARWIDTHを返す必要があります。