IMAPIFormContainer::CalcFormPropSet

適用対象: Outlook 2013 | Outlook 2016

フォーム コンテナーにインストールされているすべてのフォームで使用されるプロパティの配列を返します。

HRESULT CalcFormPropSet(
  ULONG ulFlags,
  LPMAPIFORMPROPARRAY FAR * ppResults
);

パラメーター

ulFlags

[in] ppResults パラメーターのプロパティ配列の返し方を制御するフラグのビットマスク。 次のフラグを設定できます。

FORMPROPSET_INTERSECTION

返される配列には、フォームのプロパティの積集合が含まれています。

FORMPROPSET_UNION

返される配列には、フォームのプロパティの和集合が含まれています。

MAPI_UNICODE

配列で返される文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式です。

ppResults

[out]返された SMAPIFormPropArray 構造体へのポインター。 この構造体には、インストールされているフォームで使用されるすべてのプロパティが含まれています。

戻り値

S_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B

MAPI_E_BAD_CHARWIDTH

MAPI_UNICODE フラグが設定され、実装で Unicode がサポートされていないか、MAPI_UNICODEが設定されておらず、実装で Unicode のみがサポートされています。

注釈

クライアント アプリケーションは IMAPIFormContainer::CalcFormPropSet メソッドを呼び出して、フォーム コンテナーにインストールされているすべてのフォームで使用されるプロパティの配列を取得します。 IMAPIFormContainer::CalcFormPropSet は、特定のコンテナーに登録されているすべてのフォームで動作する点を除き、 IMAPIFormMgr::CalcFormPropSet メソッドと同様に機能します。

実装に関するメモ

Unicode 文字列をサポートしていないフォーム ライブラリ プロバイダーは、MAPI_UNICODEが渡された場合にMAPI_E_BAD_CHARWIDTHを返す必要があります。

呼び出し側への注意

IMAPIFormContainer::CalcFormPropSet、ulFlags パラメーターに設定されたフラグに応じて、フォームのプロパティ セットの積集合または和集合を受け取り、結果のプロパティ グループを含む SMAPIFormPropArray 構造体を返します。

クライアントが ulFlags で MAPI_UNICODE フラグを渡す場合、返されるすべての文字列は Unicode です。

関連項目

IMAPIFormMgr::CalcFormPropSet

SMAPIFormPropArray

IMAPIFormContainer : IUnknown