PidTagMessageFlags (kanonische Eigenschaft)

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Enthält eine Bitmaske von Flags, die den Ursprung und den aktuellen Status einer Nachricht angeben.

Eigenschaft	Wert
Zugeordnete Eigenschaften:	PR_MESSAGE_FLAGS
Kennung:	0x0E07
Datentyp:	PT_LONG
Bereich:	Allgemeine Nachrichten

Hinweise

Diese Eigenschaft ist eine nicht übersetzbare Nachrichteneigenschaft, die sowohl am sendenden als auch am empfangenden Ende einer Übertragung verfügbar gemacht wird, mit unterschiedlichen Werten, je nach beteiligter Clientanwendung oder Speicheranbieter. Diese Eigenschaft wird vom Client oder Nachrichtenspeicheranbieter initialisiert, wenn eine Nachricht zum ersten Mal erstellt und gespeichert wird, und dann regelmäßig vom Nachrichtenspeicheranbieter, einem Transportanbieter und dem MAPI-Spooler aktualisiert, wenn die Nachricht verarbeitet wird und sich ihr Status ändert.

Diese Eigenschaft ist sowohl vor als auch nach der Übermittlung für eine Nachricht sowie für alle Kopien der empfangenen Nachricht vorhanden. Obwohl es sich nicht um eine Empfängereigenschaft handelt, wird sie für jeden Empfänger unterschiedlich verfügbar gemacht, je nachdem, ob sie von diesem Empfänger gelesen oder geändert wurde.

Mindestens eines der folgenden Flags kann für diese Eigenschaft festgelegt werden:

MSGFLAG_ASSOCIATED

Die Nachricht ist eine zugeordnete Nachricht eines Ordners. Der Client oder Anbieter hat schreibgeschützten Zugriff auf dieses Flag. Das MSGFLAG_READ-Flag wird für zugeordnete Nachrichten ignoriert, die keinen Lese-/Ungelesenzustand beibehalten.

MSGFLAG_FROMME

Der gesendete Messagingbenutzer war der Messagingbenutzer, der die Nachricht empfangen hat. Der Client oder Anbieter hat lese-/schreibzugriff auf dieses Flag bis zum ersten IMAPIProp::SaveChanges-Aufruf und danach schreibgeschützt. Dieses Flag soll vom Transportanbieter festgelegt werden.

MSGFLAG_HASATTACH

Die Nachricht weist mindestens eine Anlage auf. Dieses Flag entspricht der PR_HASATTACH -Eigenschaft (PidTagHasAttachments) der Nachricht. Der Client hat schreibgeschützten Zugriff auf dieses Flag.

MSGFLAG_NRN_PENDING

Für die Nachricht muss ein nicht gelesener Bericht gesendet werden. Der Client oder Anbieter hat schreibgeschützten Zugriff auf dieses Flag.

MSGFLAG_ORIGIN_INTERNET

Die eingehende Nachricht ist über das Internet eingegangen. Er stammt entweder außerhalb des organization oder aus einer Quelle, die das Gateway nicht als vertrauenswürdig betrachten kann. Der Client sollte dem Benutzer eine entsprechende Meldung anzeigen. Transportanbieter setzen diese Kennzeichnung; Der Client verfügt über schreibgeschützten Zugriff.

MSGFLAG_ORIGIN_MISC_EXT

Die eingehende Nachricht ist über einen anderen externen Link als X.400 oder das Internet eingegangen. Er stammt entweder außerhalb des organization oder aus einer Quelle, die das Gateway nicht als vertrauenswürdig betrachten kann. Der Client sollte dem Benutzer eine entsprechende Meldung anzeigen. Transportanbieter setzen diese Kennzeichnung; Der Client verfügt über schreibgeschützten Zugriff.

MSGFLAG_ORIGIN_X400

Die eingehende Nachricht ist über einen X.400-Link eingegangen. Er stammt entweder außerhalb des organization oder aus einer Quelle, die das Gateway nicht als vertrauenswürdig betrachten kann. Der Client sollte dem Benutzer eine entsprechende Meldung anzeigen. Transportanbieter setzen diese Kennzeichnung; Der Client verfügt über schreibgeschützten Zugriff.

MSGFLAG_ORIGIN_EXT_SEND

Die Nachricht stammt außerhalb des organization. Der Client sollte dem Benutzer eine entsprechende Meldung anzeigen. Transportanbieter setzen diese Kennzeichnung; Der Client verfügt über schreibgeschützten Zugriff.

MSGFLAG_READ

Die Nachricht wird als gelesen markiert. Dies kann als Ergebnis eines jederzeitigen Aufrufs von IMessage::SetReadFlag oder IMAPIFolder::SetReadFlags auftreten. Clients können dieses Flag auch festlegen, indem sie die IMAPIProp::SetProps-Methode einer Nachricht aufrufen, bevor die Nachricht zum ersten Mal gespeichert wurde. Dieses Flag wird ignoriert, wenn das MSGFLAG_ASSOCIATED-Flag festgelegt ist.

MSGFLAG_RESEND

Die Nachricht enthält eine Anforderung für einen erneuten Senden-Vorgang mit einem Nicht-Löschbericht. Der Client oder Anbieter hat lese-/schreibzugriff auf dieses Flag bis zum ersten IMAPIProp::SaveChanges-Aufruf und danach schreibgeschützt.

MSGFLAG_RN_PENDING

Für die Nachricht muss ein Lesebericht gesendet werden. Der Client oder Anbieter hat schreibgeschützten Zugriff auf dieses Flag.

MSGFLAG_SUBMIT

Die Nachricht wird als Ergebnis eines Aufrufs von IMessage::SubmitMessage zum Senden markiert. Nachrichtenspeicheranbieter legen dieses Flag fest. Der Client verfügt über schreibgeschützten Zugriff.

MSGFLAG_UNMODIFIED

Die ausgehende Nachricht wurde seit dem ersten Speichern nicht mehr geändert. Die eingehende Nachricht wurde seit der Übermittlung nicht geändert.

MSGFLAG_UNSENT

Die Nachricht wird noch erstellt. Sie wird gespeichert, wurde aber nicht gesendet. Der Client oder Anbieter hat lese-/schreibzugriff auf dieses Flag bis zum ersten IMAPIProp::SaveChanges-Aufruf und danach schreibgeschützt. Wenn ein Client dieses Flag nicht zum Zeitpunkt des Sendens der Nachricht festlegt, legt der Nachrichtenspeicheranbieter es fest, wenn IMessage::SubmitMessage aufgerufen wird. In der Regel wird dieses Flag gelöscht, nachdem die Nachricht gesendet wurde.

Ein Client- oder Nachrichtenspeicheranbieter kann den aktuellen Status der Nachricht jederzeit überprüfen, indem er die IMAPIProp::GetProps-Methode aufruft , um die Flagwerte zu lesen. Der Client oder Anbieter kann auch die IMAPIProp::SetProps-Methode aufrufen, um alle Flags zu ändern, die derzeit Lese-/Schreibzugriff haben.

Mehrere der Flags sind immer schreibgeschützt. Einige werden bis zum ersten Aufruf der IMAPIProp::SaveChanges-Methode lese-/schreibgeschützt, soweit es sich um IMAPIProp::SetProps handelt. Eine dieser MSGFLAG_READ kann später über IMessage::SetReadFlag oder IMAPIFolder::SetReadFlags geändert werden.

Die Anfangswerte für diese Eigenschaft werden in der Regel MSGFLAG_UNSENT und MSGFLAG_UNMODIFIED, um eine Nachricht anzugeben, die noch nicht gesendet oder geändert wurde. Wenn eine Nachricht zum zweiten Mal gespeichert wird, löscht der Nachrichtenspeicheranbieter das MSGFLAG_UNMODIFIED-Flag. Ein weiterer Wert, den ein Nachrichtenspeicheranbieter festlegen kann, wenn eine Nachricht gespeichert wird, ist das MSGFLAG_HASATTACH-Flag, das angibt, dass die Nachricht über eine oder mehrere Anlagen verfügt. Die PR_HASATTACH-Eigenschaft wird anhand dieser Einstellung berechnet.

Wenn ein Client die IMessage::SubmitMessage-Methode aufruft, um die Nachricht zu senden, erstellt der Nachrichtenspeicheranbieter eine Kopie davon für den MAPI-Spooler und aktualisiert diese Eigenschaft durch Festlegen des flags MSGFLAG_SUBMIT. Der Nachrichtenspeicheranbieter legt auch MSGFLAG_UNSENT fest, wenn er noch nicht festgelegt ist. MSGFLAG_SUBMIT gibt an, dass SubmitMessage aufgerufen wurde und der Sendevorgang beginnt und dass die Nachricht jetzt schreibgeschützt für den Client ist. MSGFLAG_UNSENT gibt an, dass der MAPI-Spooler die Nachricht verarbeitet. Wenn der Sendevorgang abgebrochen wird, setzt der Nachrichtenspeicheranbieter dieses Flag zurück.

Wenn die Nachricht zur Zustellung an einen Transportanbieter übergeben wird, legt der Transportanbieter das flag MSGFLAG_FROMME fest, wenn der Absender auf dem Messagingserver über dasselbe Konto verfügt, auf dem die Nachricht empfangen wurde. Transportanbieter legen MSGFLAG_FROMME für eine eingehende Nachricht fest, die vom aktuell angemeldeten Benutzer gesendet wurde. Ein Client kann diesen Wert verwenden, um festzustellen, ob es besser geeignet ist, Empfängernamen in der Inhaltstabelle des Ordners "Gesendete Elemente" anzuzeigen als Absendernamen. Nachrichten, die während des Kompositionsprozesses gespeichert und noch nicht gesendet wurden, sollten auch mit Empfängernamen anstelle von Absendernamen angezeigt werden.

Bei einer eingehenden Nachricht löscht ein Nachrichtenspeicheranbieter das MSGFLAG_READ-Flag, um die Lese-status zurückzusetzen. Ein Client kann das MSGFLAG_READ-Flag festlegen oder deaktivieren, wenn es erforderlich ist, die Lese-status zu ändern und das Senden von Lese- und Ungelesenen Berichten zu steuern, indem entweder die IMessage::SetReadFlag-Methode der Nachricht oder die IMAPIFolder::SetReadFlags-Methode des Ordners aufgerufen wird. Der Standard Unterschied zwischen diesen Methoden außer dem Objekt, das sie implementiert, besteht darin, dass sich die Folder-Methode auf eine, mehrere oder alle Nachrichten im Ordner auswirken kann. Die Nachrichtenmethode wirkt sich auf eine einzelne Nachricht aus.

Ein Client sollte auch eine eingehende Nachricht für die Flags MSGFLAG_ORIGIN_X400, MSGFLAG_ORIGIN_INTERNET, MSGFLAG_ORIGIN_MISC_EXT und MSGFLAG_ORIGIN_EXT_SEND testen. Diese Flags werden vom Eingehenden Transportanbieter festgelegt und geben an, dass die Nachricht von einer Quelle empfangen wurde, die das Gateway nicht als vertrauenswürdig betrachten kann. Dies bedeutet, dass die Nachricht entweder außerhalb des organization oder intern, aber von einer Arbeitsstation stammt, die dem Gateway nicht bekannt ist. In jedem Fall kann die Identität des Absenders nicht bestätigt werden, und es besteht die Gefahr, dass ein Computervirus in den organization. Der Client sollte dem Benutzer eine Warnmeldung anzeigen und die Möglichkeit bieten, die Nachricht zu löschen, ohne sie zu öffnen.

Nachrichtenspeicheranbieter legen das MSGFLAG_UNMODIFIED-Flag für eingehende Nachrichten fest. MSGFLAG_UNMODIFIED gibt an, dass eine Nachricht seit der Übermittlung nicht geändert wurde. Ein Client kann diesen Wert nicht löschen, nachdem er von einem Nachrichtenspeicheranbieter festgelegt wurde.