IMAPIFormMgr::IsInConflict
Gilt für: Outlook 2013 | Outlook 2016
Bestimmt, ob ein Formular seine eigenen Nachrichtenkonflikte behandeln kann. Eine Nachricht ist in Konflikt, wenn sie von mehreren Benutzern gleichzeitig bearbeitet wurde. Dies kann bei Nachrichten in öffentlichen Ordnern der Fall sein.
HRESULT IsInConflict(
ULONG ulMessageFlags,
ULONG ulMessageStatus,
LPCSTR szMessageClass LPMAPIFOLDER pFolderFocus
);
Parameter
ulMessageFlags
[in] Ein Zeiger auf eine Bitmaske von Flags, die aus der eigenschaft PR_MESSAGE_FLAGS (PidTagMessageFlags) einer Nachricht kopiert wurden, die den aktuellen Status der Nachricht angibt.
ulMessageStatus
[in] Eine Bitmaske von clientdefinierten oder vom Anbieter definierten Flags, die aus der eigenschaft PR_MSG_STATUS (PidTagMessageStatus) einer Nachricht kopiert wurden, die zusätzliche Informationen zum Status der Nachricht bereitstellt.
szMessageClass
[in] Eine Zeichenfolge, die die Nachrichtenklasse der Nachricht benennt.
pFolderFocus
[in] Ein Zeiger auf den Ordner, der die Nachricht enthält. Der pFolderFocus-Parameter kann NULL sein, wenn ein solcher Ordner nicht vorhanden ist (z. B. wenn die Nachricht in eine andere Nachricht eingebettet ist).
Rückgabewert
S_OK
Das Formular behandelt keine eigenen Nachrichtenkonflikte.
S_FALSE
Das Formular behandelt seine eigenen Nachrichtenkonflikte, oder die Nachricht, für die Informationen übergeben wurden, ist nicht in Konflikt.
Hinweise
Formular-Viewer rufen die IMAPIFormMgr::IsInConflict-Methode auf, um zu ermitteln, ob ein bestimmtes Formular seine eigenen Nachrichtenkonflikte nicht behandelt. IsInConflict überprüft die Bitmasken in den Parametern ulMessageFlags und ulMessageStatus auf das Vorhandensein eines Konfliktflags. Wenn ein Konfliktflag festgelegt ist, löst IsInConflict die im szMessageClass-Parameter übergebene Nachrichtenklasse auf und gibt S_OK zurück, wenn das Formular keine eigenen Konflikte behandelt. IsInConflict gibt S_FALSE zurück, wenn das Formular seine eigenen Konflikte behandelt.
Ein Formular, das keine eigenen Konflikte behandelt, muss mit der IMAPIFormMgr::LoadForm-Methode geöffnet werden und kann kein vorhandenes Formularobjekt wiederverwenden.
Hinweise für Aufrufer
Clientanwendungen müssen in der Regel mit Konflikten umgehen, wenn die Anwendungen von einer Nachricht zur nächsten oder vorherigen Nachricht in einem Ordner wechseln. Wenn eine Nachricht in Konflikt steht, aber der Formularserver für diese Nachricht Konflikte behandeln kann, sollte die Clientanwendung ihren üblichen Code zum Anzeigen der nächsten oder vorherigen Nachricht ausführen. Wenn der Formularserver Konflikte nicht verarbeiten kann, sollte die Clientanwendung so fortgesetzt werden, als ob sie die Nachrichtenklasse der nächsten oder vorherigen Nachricht nicht kennen würde.
Siehe auch
IMAPIFormAdviseSink::OnActivateNext
PidTagMessageFlags (kanonische Eigenschaft)