IMAPIFormContainer::ResolveMultipleMessageClasses
Hace referencia a: Outlook 2013 | Outlook 2016
Resuelve un grupo de clases de mensajes en sus formularios en un contenedor de formularios y devuelve una matriz de objetos de información de formulario para esos formularios.
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClassArray,
ULONG ulFlags,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parameters
pMsgClassArray
[in] Puntero a una matriz que contiene los nombres de las clases de mensaje que se van a resolver. Los nombres de clase de mensaje siempre son cadenas ANSI, nunca Unicode.
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.
ppfrminfoarray
[out] Puntero a un puntero a una matriz de objetos de información de formulario. Si una aplicación cliente pasa NULL en el parámetro pMsgClassArray , 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
Las aplicaciones cliente llaman al método IMAPIFormContainer::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 el parámetro 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, pase 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), la marca de MAPIFORM_EXACTMATCH se puede pasar en el parámetro ulFlags .
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, no suponga que todas las clases de mensaje se han resuelto correctamente. En su lugar, compruebe los valores de la matriz devuelta.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| FormContainerDlg.cpp |
CFormContainerDlg::OnResolveMultipleMessageClasses |
MFCMAPI usa el método IMAPIFormContainer::ResolveMultipleMessageClasses para buscar un formulario asociado a un conjunto de clases de mensajes. |