IMAPIFormMgr::ResolveMultipleMessageClasses
Hace referencia a: Outlook 2013 | Outlook 2016
Resuelve un grupo de clases de mensajes en sus formularios dentro de un contenedor de formularios y devuelve una matriz de objetos de información de formulario para esos formularios.
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClasses,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parameters
pMsgClasses
[in] Puntero a una matriz que contiene los nombres de las clases de mensaje que se van a resolver.
ulFlags
[in] Máscara de bits de marcas que controla cómo se resuelven las clases de mensaje. Se puede establecer la marca siguiente:
MAPIFORM_EXACTMATCH
Solo se deben resolver las cadenas de clase de mensaje que son una coincidencia exacta.
MAPIFORM_LOCALONLY
No incluya formularios almacenados en caché.
pFolderFocus
[in] Puntero a la carpeta que contiene el formulario cuya clase de mensaje se está resolviendo. El parámetro pFolderFocus puede ser NULL.
ppfrminfoarray
[out] Puntero a un puntero a una matriz de objetos de información de formulario. Si un visor de formularios pasa NULL en el parámetro pMsgClasses , el parámetro ppfrminfoarray contiene objetos de información de formulario para todos los formularios del contenedor.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
Comentarios
Los visores de formularios llaman al método IMAPIFormMgr::ResolveMultipleMessageClasses para resolver un grupo de clases de mensajes en formularios dentro de un contenedor de formularios. La matriz de objetos de información de formulario devueltos en ppfrminfoarray proporciona más acceso a cada una de las propiedades de los formularios.
Notas para los llamadores
Para resolver un grupo de clases de mensajes en formularios, un visor de formularios pasa una matriz de nombres de clase de mensaje que se van a resolver. Para forzar que la resolución sea exacta (es decir, para evitar la resolución en una clase base de la clase de mensaje cuando no está disponible un servidor de formularios que coincida exactamente) se puede pasar la marca de MAPIFORM_EXACTMATCH en el parámetro ulFlags .
Los nombres de clase de mensaje siempre son cadenas ANSI, nunca Unicode.
Si una clase de mensaje no se puede resolver en un formulario, se devuelve NULL para esa clase de mensaje en la matriz de información del formulario. Por lo tanto, incluso si el método devuelve S_OK, los visores de formularios no deberían funcionar suponiendo que todas las clases de mensaje se hayan resuelto correctamente. En su lugar, los visores de formularios deben comprobar los valores de la matriz devuelta.