IMAPIFormMgr::ResolveMessageClass
Hace referencia a: Outlook 2013 | Outlook 2016
Resuelve una clase de mensaje en su formulario dentro de un contenedor de formularios y devuelve un objeto de información de formulario para ese formulario.
HRESULT ResolveMessageClass(
LPCSTR szMsgClass,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPMAPIFORMINFO FAR * ppResult
);
Parameters
szMsgClass
[in] Cadena que asigna un nombre a la clase de mensaje que se va a resolver.
ulFlags
[in] Máscara de bits de marcas que controla cómo se resuelve la clase 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.
pFolderFocus
[in] Puntero a la carpeta que contiene el mensaje que se va a resolver. El parámetro pFolderFocus puede ser NULL.
ppResult
[out] Puntero a un puntero a un objeto de información de formulario devuelto.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
MAPI_E_NOT_FOUND
La clase de mensaje pasada en el parámetro szMsgClass no coincide con la clase de mensaje de ningún formulario de la biblioteca de formularios.
Comentarios
Los visores de formularios llaman al método IMAPIFormMgr::ResolveMessageClass para resolver una clase de mensaje en su formulario dentro de un contenedor de formularios. El objeto de información de formulario devuelto en el parámetro ppResult proporciona más acceso a las propiedades del formulario que tiene la clase de mensaje especificada.
Notas para los llamadores
Para resolver una clase de mensaje en un formulario, un visor de formulario pasa el nombre de la clase de mensaje que se va a resolver, como " IPM.HelpDesk.Software". 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), la marca de MAPIFORM_EXACTMATCH se puede pasar en el parámetro ulFlags . Si el parámetro pFolderFocus es NULL, el proceso de resolución de clase de mensaje no busca en un contenedor de carpetas.
El orden de los contenedores buscados depende de la implementación del proveedor de la biblioteca de formularios. El proveedor de biblioteca de formularios predeterminado busca primero el contenedor local, después el contenedor de carpetas para la carpeta pasada, el contenedor de formularios personales y, por último, el contenedor de la organización.
Los nombres de clase de mensaje siempre son cadenas ANSI, nunca Unicode.
El identificador de clase de la clase de mensaje resuelto se devuelve como parte del objeto de información de formulario. Un visor de formularios no debe funcionar suponiendo que el identificador de clase exista en la biblioteca OLE hasta que el visor de formularios haya llamado al método IMAPIFormMgr::P repareForm o al método IMAPIFormMgr::CreateForm .