Übersicht über die MAPI-Eigenschaft
Gilt für: Outlook 2013 | Outlook 2016
Eine Eigenschaft ist ein Attribut eines MAPI-Objekts. Eigenschaften beschreiben etwas über das Objekt, z. B. die Betreffzeile einer Nachricht oder den Adresstyp eines Messagingbenutzers. MAPI definiert viele Eigenschaften, einige zur Beschreibung vieler Objekte und andere, die nur für ein Objekt eines bestimmten Typs geeignet sind. Clients und Dienstanbieter können den MapI-Satz vordefinierter Eigenschaften erweitern, indem sie neue, benutzerdefinierte Eigenschaften erstellen. Clients können Eigenschaften definieren, um neue Nachrichtenklassen zu beschreiben, und Dienstanbieter können Eigenschaften definieren, um die einzigartigen Features ihres Messagingsystems verfügbar zu machen.
Eigenschaften können persistent oder temporär sein. Eigenschaften, die von Sitzung zu Sitzung beibehalten werden, können mit den Daten ihrer Objekte oder im Profil gespeichert werden. Temporäre Eigenschaften sind nur für die Dauer der aktuellen Sitzung vorhanden.
Clients und Dienstanbieter können Benutzern Eigenschaften mit einer Tabelle oder einem Eigenschaftenblatt anzeigen. Tabellen bieten Benutzern eine schreibgeschützte Ansicht einiger eigenschaften, die zu mehreren Objekten gehören. Die Daten werden im Zeilen- und Spaltenformat angezeigt, wobei jede Zeile ein Objekt und jede Spalte eine Eigenschaft darstellt. Eigenschaftenblätter sind Dialogfelder im Registerkartenformat, in denen verwandte Eigenschaften für ein einzelnes Objekt angezeigt werden. Eigenschaftenblätter können schreibgeschützten oder Lese-/Schreibzugriff auf die Daten bereitstellen. Ob ein Benutzer Änderungen vornehmen darf, hängt vom Implementierer des Eigenschaftenblatts ab.
Die IMAPIProp-Schnittstelle ist die primäre Schnittstelle zum Arbeiten mit Eigenschaften. Alle Objekte, die Eigenschaften unterstützen, implementieren IMAPIProp. IMAPIProp enthält Methoden zum Abrufen von Eigenschaftswerten, Zum Kopieren von Eigenschaften, Zum Vornehmen von Änderungen und Speichern dieser Änderungen, zum Zuordnen zwischen Eigenschaftennamen und ihren Bezeichnern sowie zum Abrufen von Informationen zu einem früheren Fehler.
Es gibt mehrere Datenstrukturen zum Beschreiben von Eigenschaften und Informationen zu Eigenschaften. Die am häufigsten verwendeten Strukturen sind die SPropValue-Struktur und die SPropTagArray-Struktur . Die SPropValue-Struktur enthält die drei Informationen, die eine Eigenschaft beschreiben:
Daten oder Werte der Eigenschaft.
Datentyp des Werts der Eigenschaft, z. B. integer oder Boolean.
Numerischer Wert innerhalb eines bestimmten Bereichs, der die Eigenschaft und die Komponente, die für die Verwaltung verantwortlich ist, eindeutig identifizieren. Beispielsweise gibt es einen Bereich zum Aufnehmen von Nachrichteninhaltseigenschaften, die von DER MAPI definiert werden, und einen anderen Bereich für nachrichteninhaltseigenschaften, die von einem Client für eine benutzerdefinierte Nachrichtenklasse definiert werden.
Der Eigenschaftentyp und der Bezeichner werden in einer einzelnen Komponente kombiniert, die als Eigenschaftstag bezeichnet wird. Eigenschaftstags sind Konstanten, die verwendet werden können, um problemlos auf die Eigenschaft zu verweisen. Eigenschaftentags für von MAPI definierte Eigenschaften sind in der MAPITAGS enthalten. H-Headerdatei und im ulPropTag-Member einer SPropValue-Struktur . Clients und Dienstanbieter verwenden Eigenschaftstags, um die entsprechenden Eigenschaften zu identifizieren, abzurufen und zu aktualisieren.
Die SPropTagArray-Struktur ist ein gezähltes Array von Eigenschaftstags. Viele der Methoden in IMAPIProp und anderen Schnittstellen verwenden eine SPropTagArray-Struktur zum Beschreiben von Eigenschaften.