IMAPIFormMgr::CalcFormPropSet
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve una matriz de las propiedades que usa un grupo de formularios.
HRESULT CalcFormPropSet(
LPSMAPIFORMINFOARRAY pfrminfoarray,
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Parameters
pfrminfoarray
[in] Puntero a una matriz de objetos de información de formulario que identifican los formularios para los que se van a devolver propiedades.
ulFlags
[in] Máscara de bits de marcas que controla cómo se devuelve la matriz de propiedades en el parámetro ppResults . Se pueden establecer las siguientes marcas:
FORMPROPSET_INTERSECTION
La matriz devuelta contiene la intersección de las propiedades del formulario.
FORMPROPSET_UNION
La matriz devuelta contiene la unión de las propiedades del formulario.
MAPI_UNICODE
Las cadenas devueltas en la matriz están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las cadenas están en formato ANSI.
ppResults
[out] Puntero a un puntero a la estructura SMAPIFormPropArray devuelta, que contiene las propiedades que usan los formularios.
Valor devuelto
S_OK
La llamada se realizó correctamente y devolvió el valor o los valores esperados.
MAPI_E_BAD_CHARWIDTH
Se estableció la marca de MAPI_UNICODE y la implementación no admite Unicode, o MAPI_UNICODE no se estableció y la implementación solo admite Unicode.
Comentarios
Los visores de formularios llaman al método IMAPIFormMgr::CalcFormPropSet para obtener una matriz de las propiedades que usa un grupo de formularios. CalcFormPropSet toma una intersección o una unión de los conjuntos de propiedades de estos formularios, dependiendo del marcador establecido en el parámetro ulFlags , y devuelve una estructura SMAPIFormPropArray que contiene el grupo resultante de propiedades.
Notas a los implementadores
Si un visor de formularios pasa la marca de MAPI_UNICODE en el parámetro ulFlags , todas las cadenas deben devolverse como cadenas Unicode. Los proveedores de bibliotecas de formularios que no admiten cadenas Unicode deben devolver MAPI_E_BAD_CHARWIDTH si se pasa MAPI_UNICODE.