MAPI-Eintragsbezeichner
Gilt für: Outlook 2013 | Outlook 2016
Eingabebezeichner sind Binärdaten, die in einer ENTRYID-Struktur gespeichert sind und zum eindeutigen Identifizieren und Öffnen eines MAPI-Objekts verwendet werden. Die meisten MAPI-Objekte verfügen über Eingabebezeichner. Eintragsbezeichner für Objekte sind analog zu Dateinamen für Dateien. Sie sind jedoch nicht übertragbar und können nicht auf anderen Systemen als dem System verwendet werden, auf dem sie entstanden sind.
Eintragsbezeichner
Nachrichtenspeicheranbieter weisen Nachrichtenspeichern, Ordnern und Nachrichten Eingabebezeichner zu. Adressbuchanbieter weisen sie Adressbuchcontainern, Verteilerlisten und Messagingbenutzern zu. Eintragsbezeichner werden auch verwendet, um ein Objekt zu öffnen, das durch eine Zeile in einer Tabelle dargestellt wird, z. B. ein status -Objekt in der status Tabelle. Objekte speichern ihre Eintragsbezeichner in ihrer PR_ENTRYID -Eigenschaft (PidTagEntryId).
Während Dienstanbieter Eingabebezeichner erstellen, zuweisen und untersuchen, verwenden Clientanwendungen diese nur als Tools zum Öffnen von Objekten. Für Clients sind Eingabebezeichner nicht transparente Binärdaten und haben nichts mit dem zugrunde liegenden Messagingsystem zu tun.
Clients rufen die IMAPIProp::GetProps-Methode eines Objekts auf, um die PR_ENTRYID-Eigenschaft oder die IMAPITable::QueryColumns-Methode einer Tabelle abzurufen, um die Spalte abzurufen, die die PR_ENTRYID-Eigenschaft enthält.
Eingabebezeichner werden als Parameter an die Methoden OpenEntry und CompareEntryIDs übergeben. Mehrere MAPI-Objekte implementieren die Methoden OpenEntry und CompareEntryIDs . Mit OpenEntry können Clients ein Objekt öffnen. Mit CompareEntryIDs können Clients zwei Eintragsbezeichner vergleichen, um zu bestimmen, ob sie auf dasselbe Objekt verweisen. Da Eingabebezeichner nicht unbedingt binär vergleichbar sind, müssen Clients sie mit der CompareEntryIDs-Methode vergleichen.
Clients sollten immer natürlich ausgerichtete Eingabebezeichner in ihren Aufrufen an Dienstanbieter übergeben, denn obwohl Dienstanbieter Eintragsbezeichner behandeln sollten, die willkürlich ausgerichtet sind, ist dies nicht immer der Fall. Eine natürlich ausgerichtete Speicheradresse ermöglicht es dem Computer, auf jeden Datentyp zuzugreifen, den er an dieser Adresse unterstützt, ohne einen Ausrichtungsfehler zu erzeugen. Der natürliche Ausrichtungsfaktor ist in der Regel der gleiche Ausrichtungsfaktor, der von der Systemspeicherzuordnung verwendet wird, und beträgt in der Regel 8 Bytes.
Eingabebezeichner gibt es in zwei Arten: kurz- und langfristig. Kurzfristige Eingabebezeichner sind schneller zu erstellen, aber ihre Eindeutigkeit ist nur während der Lebensdauer der aktuellen Sitzung auf der aktuellen Arbeitsstation garantiert. Langzeiteintrags-IDs haben eine längere Lebensdauer. Bezeichner für kurzfristige Einträge werden in erster Linie für Zeilen in Tabellen und Einträge in Dialogfeldern verwendet, während langfristige Eingabebezeichner für viele Objekte wie Nachrichten, Ordner und Verteilerlisten verwendet werden.