IMAPIFormContainer::CalcFormPropSet
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve una matriz de las propiedades usadas por todos los formularios instalados en un contenedor de formularios.
HRESULT CalcFormPropSet(
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Parameters
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 de los formularios.
FORMPROPSET_UNION
La matriz devuelta contiene la unión de las propiedades de los formularios.
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. Esta estructura contiene todas las propiedades usadas por los formularios instalados.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
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
Las aplicaciones cliente llaman al método IMAPIFormContainer::CalcFormPropSet para obtener una matriz de propiedades usadas por todos los formularios instalados en un contenedor de formularios. IMAPIFormContainer::CalcFormPropSet funciona como el método IMAPIFormMgr::CalcFormPropSet , salvo que funciona en todos los formularios registrados en un contenedor determinado.
Notas a los implementadores
Los proveedores de bibliotecas de formularios que no admiten cadenas Unicode deben devolver MAPI_E_BAD_CHARWIDTH si se pasa MAPI_UNICODE.
Notas para los llamadores
IMAPIFormContainer::CalcFormPropSet toma una intersección o una unión de los conjuntos de propiedades de los formularios, en función de la marca establecida en el parámetro ulFlags , y devuelve una estructura SMAPIFormPropArray que contiene el grupo de propiedades resultante.
Si un cliente pasa la marca MAPI_UNICODE en ulFlags, todas las cadenas devueltas son Unicode.