IMAPIFormMgr::IsInConflict
Hace referencia a: Outlook 2013 | Outlook 2016
Determina si un formulario puede controlar sus propios conflictos de mensajes. Un mensaje está en conflicto si más de un usuario lo ha editado simultáneamente. Esto puede suceder con los mensajes de carpetas públicas.
HRESULT IsInConflict(
ULONG ulMessageFlags,
ULONG ulMessageStatus,
LPCSTR szMessageClass LPMAPIFOLDER pFolderFocus
);
Parameters
ulMessageFlags
[in] Puntero a una máscara de bits de marcas copiadas de la propiedad PR_MESSAGE_FLAGS (PidTagMessageFlags) de un mensaje que indica el estado actual del mensaje.
ulMessageStatus
[in] Máscara de bits de marcas definidas por el cliente o definidas por el proveedor copiadas de la propiedad PR_MSG_STATUS (PidTagMessageStatus) de un mensaje que proporciona información adicional sobre el estado del mensaje.
szMessageClass
[in] Cadena que asigna un nombre a la clase de mensaje del mensaje.
pFolderFocus
[in] Puntero a la carpeta que contiene el mensaje. El parámetro pFolderFocus puede ser NULL si dicha carpeta no existe (por ejemplo, si el mensaje está incrustado en otro mensaje).
Valor devuelto
S_OK
El formulario no controla sus propios conflictos de mensajes.
S_FALSE
El formulario controla sus propios conflictos de mensajes o el mensaje para el que se pasó información no está en conflicto.
Comentarios
Los visores de formularios llaman al método IMAPIFormMgr::IsInConflict para detectar si un formulario determinado no controla sus propios conflictos de mensajes. IsInConflict comprueba las máscaras de bits de los parámetros ulMessageFlags y ulMessageStatus para la presencia de una marca de conflicto. Si se establece una marca de conflicto, IsInConflict resuelve la clase de mensaje pasada en el parámetro szMessageClass y devuelve S_OK si el formulario no controla sus propios conflictos. IsInConflict devuelve S_FALSE si el formulario controla sus propios conflictos.
Un formulario que no controla sus propios conflictos debe abrirse mediante el método IMAPIFormMgr::LoadForm y no puede reutilizar un objeto de formulario existente.
Notas para los llamadores
Las aplicaciones cliente suelen tener que lidiar con conflictos cuando las aplicaciones se mueven de un mensaje al mensaje siguiente o anterior de una carpeta. Si un mensaje está en conflicto, pero el servidor de formularios de ese mensaje puede controlar conflictos, la aplicación cliente debe ejecutar su código habitual para mostrar el mensaje siguiente o anterior. Si el servidor de formularios no puede controlar conflictos, la aplicación cliente debe continuar como si no estuviera al tanto de la clase de mensaje del mensaje siguiente o anterior.
Vea también
IMAPIFormAdviseSink::OnActivateNext
Propiedad canónica PidTagMessageFlags