IMAPIFormMgr::IsInConflict
Aplica-se a: Outlook 2013 | Outlook 2016
Determina se um formulário pode lidar com seus próprios conflitos de mensagem. Uma mensagem estará em conflito se ela tiver sido editada simultaneamente por mais de um usuário. Isso pode acontecer com mensagens em pastas públicas.
HRESULT IsInConflict(
ULONG ulMessageFlags,
ULONG ulMessageStatus,
LPCSTR szMessageClass LPMAPIFOLDER pFolderFocus
);
Parâmetros
ulMessageFlags
[in] Um ponteiro para um bitmask de sinalizadores copiados da propriedade PR_MESSAGE_FLAGS (PidTagMessageFlags) de uma mensagem que indica o estado atual da mensagem.
ulMessageStatus
[in] Um bitmask de sinalizadores definidos pelo cliente ou definidos pelo provedor copiados da propriedade PR_MSG_STATUS (PidTagMessageStatus) de uma mensagem que fornece informações adicionais sobre o estado da mensagem.
szMessageClass
[in] Uma cadeia de caracteres que nomeia a classe de mensagem da mensagem.
pFolderFocus
[in] Um ponteiro para a pasta que contém a mensagem. O parâmetro pFolderFocus pode ser NULL se essa pasta não existir (por exemplo, se a mensagem estiver inserida em outra mensagem).
Valor de retorno
S_OK
O formulário não lida com seus próprios conflitos de mensagem.
S_FALSE
O formulário manipula seus próprios conflitos de mensagem ou a mensagem para a qual as informações foram passadas não está em conflito.
Comentários
Os visualizadores de formulário chamam o método IMAPIFormMgr::IsInConflict para descobrir se um formulário específico não lida com seus próprios conflitos de mensagem. IsInConflict verifica os bitmasks nos parâmetros ulMessageFlags e ulMessageStatus para a presença de um sinalizador de conflito. Se um sinalizador de conflito for definido, IsInConflict resolverá a classe de mensagem passada no parâmetro szMessageClass e retornará S_OK se o formulário não manipular seus próprios conflitos. IsInConflict retornará S_FALSE se o formulário lidar com seus próprios conflitos.
Um formulário que não manipula seus próprios conflitos deve ser aberto usando o método IMAPIFormMgr::LoadForm e não pode reutilizar um objeto de formulário existente.
Notas para chamadores
Os aplicativos cliente normalmente precisam lidar com conflitos quando os aplicativos passam de uma mensagem para a próxima ou mensagem anterior em uma pasta. Se uma mensagem estiver em conflito, mas o servidor de formulários dessa mensagem puder lidar com conflitos, o aplicativo cliente deverá executar seu código habitual para exibir a próxima ou anterior mensagem. Se o servidor de formulário não puder lidar com conflitos, o aplicativo cliente deverá continuar como se não tivesse conhecimento da classe de mensagem da próxima ou anterior mensagem.
Confira também
IMAPIFormAdviseSink::OnActivateNext
Propriedade Canônica PidTagMessageFlags