IMAPIFormMgr::CalcFormPropSet
Область применения: Outlook 2013 | Outlook 2016
Возвращает массив свойств, которые использует группа форм.
HRESULT CalcFormPropSet(
LPSMAPIFORMINFOARRAY pfrminfoarray,
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Параметры
pfrminfoarray
[в] Указатель на массив объектов сведений о форме, определяющих формы, для которых возвращаются свойства.
ulFlags
[в] Битовая маска флагов, управляющая тем, как возвращается массив свойств в параметре ppResults . Можно задать следующие флаги:
FORMPROPSET_INTERSECTION
Возвращаемый массив содержит пересечение свойств формы.
FORMPROPSET_UNION
Возвращаемый массив содержит объединение свойств формы.
MAPI_UNICODE
Строки, возвращаемые в массиве, имеют формат Юникода. Если флаг MAPI_UNICODE не задан, строки имеют формат ANSI.
ppResults
[out] Указатель на указатель на возвращаемую структуру SMAPIFormPropArray , которая содержит свойства, используемые формами.
Возвращаемое значение
S_OK
Вызов выполнен успешно и возвращает ожидаемое значение или значения.
MAPI_E_BAD_CHARWIDTH
Либо был установлен флаг MAPI_UNICODE и реализация не поддерживает Юникод, либо MAPI_UNICODE не задан и реализация поддерживает только Юникод.
Замечания
Средства просмотра форм вызывают метод IMAPIFormMgr::CalcFormPropSet , чтобы получить массив свойств, которые использует группа форм. CalcFormPropSet принимает пересечение или объединение наборов свойств этих форм в зависимости от флага, установленного в параметре ulFlags , и возвращает структуру SMAPIFormPropArray , содержащую результирующая группа свойств.
Примечания для исполнителей
Если средство просмотра форм передает флаг MAPI_UNICODE в параметре ulFlags , все строки должны возвращаться в виде строк Юникода. Поставщики библиотек форм, которые не поддерживают строки Юникода, должны возвращать MAPI_E_BAD_CHARWIDTH при передаче MAPI_UNICODE.