Übersicht über Nachrichteneigenschaften
Gilt für: Outlook 2013 | Outlook 2016
MAPI unterteilt Nachrichteneigenschaften in drei Typen:
Nachrichteninhaltseigenschaften.
Nachrichtenübertragungs- oder Umschlageigenschaften.
Nachrichtenempfängereigenschaften.
Nachrichteninhaltseigenschaften beschreiben den Text einer Nachricht. Jede Nachrichtenklasse verfügt über einen eigenen Satz von Inhaltseigenschaften. MAPI definiert Inhaltseigenschaften für Notiz- und Berichtsnachrichten; Es liegt an den Clients und Nachrichtenspeicheranbietern, die diese Nachrichtenklassen verarbeiten, die Eigenschaften entsprechend für ihre Implementierungen festzulegen. PR_BODY (PidTagBody) und PR_RTF_COMPRESSED (PidTagRtfCompressed) sind Beispiele für Inhaltseigenschaften für Notiznachrichten. PR_BODY enthält den unformatierten Inhalt einer Notiz, während PR_RTF_COMPRESSED die komprimierte Version des formatierten Inhalts einer Notiz enthält. Weitere Informationen zu Eigenschaftsbezeichnerbereichen finden Sie unter Eigenschaftenbezeichnerbereiche.
Für neue Nachrichtenklassen können Clients inhaltsspezifische Eigenschaften auf eine von zwei Arten definieren:
Mithilfe von Eigenschaftsbezeichnern im Inhaltseigenschaftenbereich der benutzerdefinierten Nachrichtenklasse: 0x6800 bis 0x7BFF.
Mithilfe von benannten Eigenschaften mit Bezeichnern, die in den 0x8000 durch 0xFFFE Bereich fallen.
Der Bezeichnerbereich für benutzerdefinierte Nachrichtenklasseninhaltseigenschaften ist für jeden Client verfügbar, der eine benutzerdefinierte Nachrichtenklasse erstellt. Daher kann ein Eigenschaftenbezeichner in diesem Bereich für mehrere Nachrichtenklassen verwendet werden. Benutzer von Eigenschaften in diesem Bereich können keine Annahmen über das Verhalten der Eigenschaften treffen.
Für benannte Eigenschaften erstellen Clients einen Namen, der einen Eigenschaftensatz und entweder eine Zeichenfolge oder einen numerischen Wert für jede neue Eigenschaft angibt. Clients ordnen die Eigenschaft dann einem Bezeichner im benannten Eigenschaftenbereich zu. Benutzer benannter Eigenschaften greifen über die Methoden IMAPIProp::GetIDsFromNames und IMAPIProp::GetNamesFromIDs nach Name oder Bezeichner auf sie zu.
Umschlageigenschaften stellen Informationen bereit, die zum Übertragen einer Nachricht von einem Empfänger an einen anderen verwendet werden. Wie bei Nachrichteninhaltseigenschaften ist es für Clients oder Dienstanbieter möglich, eigene Umschlageigenschaften zu definieren, um die von MAPI definierten Eigenschaften zu ergänzen. Clients und Transportanbieter legen die Umschlageigenschaften fest, die MAPI basierend auf der von MAPI bereitgestellten Definition definiert. Transportanbieter, die spezielle Features implementieren, können eigene Umschlageigenschaften definieren, um diese Features für Clients verfügbar zu machen. MAPI legt einen Bereich von Eigenschaftenbezeichnern fest, die für diese speziellen vom Anbieter definierten Eigenschaften verwendet werden können. Transportanbieter implementieren in der Regel eine spezielle Eigenschaftenseite, um diese Eigenschaften anzuzeigen und Clients zu ermöglichen, sie zu ändern. PR_SUBJECT (PidTagSubject) und PR_MESSAGE_CLASS (PidTagMessageClass) sind Beispiele für Umschlageigenschaften. Weitere Informationen finden Sie unter Eigenschaftenbezeichnerbereiche.
Empfängereigenschaften beschreiben das Ziel für eine gesendete Nachricht. Ein Empfänger kann ein Messagingbenutzer, eine Verteilerliste oder ein Computer sein. Empfängereigenschaften werden von MAPI definiert und von Dienstanbietern festgelegt. Einige Empfängereigenschaften werden von Adressbuchanbietern für ihre Messagingbenutzer- und Verteilerlistenobjekte unterstützt. andere Empfängereigenschaften werden von Clients, Nachrichtenspeicheranbietern oder Transportanbietern unterstützt. Beispielsweise benötigen alle Empfänger eine Adresse und einen Adresstyp. Dies sind Eigenschaften, die von einem Adressbuchanbieter verwaltet werden, wenn der Empfänger in einem seiner Container gespeichert wird. Empfänger verfügen auch über den Typ PR_RECIPIENT_TYPE (PidTagRecipientType), der einen Empfänger entweder als primärer Empfänger, als Carbon Copy- oder blinde Carbon Copy-Empfänger identifiziert.
Viele Nachrichteneigenschaften sind optional, was bedeutet, dass Clients nicht erwarten können, dass sie verfügbar sind oder auf gültige Werte festgelegt sind. Einige Nachrichteneigenschaften sind erforderlich, aber nur verfügbar, wenn sich eine Nachricht in einem bestimmten Zustand befindet. Beispielsweise muss eine neu erstellte Nachricht erst nach dem Speichern der Nachricht über einen Eintragsbezeichner verfügen, und sie muss erst dann über eine Nachrichtenklasse verfügen, wenn die Nachricht für die Übermittlung bereit ist. Clients sollten immer die Ergebnisse ihrer IMAPIProp::GetProps - und IMAPIProp::OpenProperty-Aufrufe überprüfen und Standardwerte als Sicherung bereit halten, falls eine angeforderte Eigenschaft nicht verfügbar ist.
Die meisten Nachrichteneigenschaften, die Dienstanbieter festlegen, sind für Clients schreibgeschützt.