Freigeben über


ENTRYID

Gilt für: Outlook 2013 | Outlook 2016

Enthält einen Eintragsbezeichner für ein MAPI-Objekt.

Eigenschaft Wert
Headerdatei
Mapidefs.h
Verwandte Makros:
CbNewENTRYID, SizedENTRYID
typedef struct
{
  BYTE abFlags[4];
  BYTE ab[MAPI_DIM];
} ENTRYID, FAR *LPENTRYID;

Members

abFlags

Bitmaske von Flags, die Informationen bereitstellen, die das Objekt beschreiben. Nur das erste Byte der Flags, abFlags[0], kann vom Anbieter festgelegt werden; die anderen drei sind reserviert. Diese Flags dürfen nicht für permanente Eintragsbezeichner festgelegt werden. Sie werden nur für bezeichner für kurzfristige Einträge festgelegt. Für Clients ist diese Struktur schreibgeschützt. Die folgenden Flags können in abFlags[0] festgelegt werden:

MAPI_NOTRECIP

Der Eintragsbezeichner kann nicht als Empfänger für eine Nachricht verwendet werden.

MAPI_NOTRESERVED

Andere Benutzer können nicht auf den Eintragsbezeichner zugreifen.

MAPI_NOW

Der Eintragsbezeichner kann nicht zu anderen Zeiten verwendet werden.

MAPI_SHORTTERM

Der Eintragsbezeichner ist kurzfristig. Alle anderen Werte in diesem Byte müssen festgelegt werden, es sei denn, andere Verwendungen des Eintragsbezeichners sind aktiviert.

MAPI_THISSESSION

Der Eintragsbezeichner kann nicht in anderen Sitzungen verwendet werden.

ab

Gibt ein Array von Binärdaten an, das von Dienstanbietern verwendet wird. Die Clientanwendung kann dieses Array nicht verwenden.

Hinweise

Die ENTRYID-Struktur wird von Nachrichtenspeicher- und Adressbuchanbietern verwendet, um eindeutige Bezeichner für ihre Objekte zu erstellen. Eingabebezeichner werden verwendet, um die folgenden Objekttypen zu identifizieren:

  • Nachrichtenspeicher

  • Ordner

  • Nachrichten

  • Adressbuchcontainer

  • Verteilerlisten

  • Messagingbenutzer

  • Statusobjekte

  • Profilabschnitte

Jeder Anbieter verwendet ein Format für die ENTRYID-Struktur , das für diesen Anbieter sinnvoll ist.

Eintragsbezeichner lassen sich nicht direkt miteinander vergleichen, da ein Objekt durch zwei unterschiedliche binäre Werte dargestellt werden kann. Um zu bestimmen, ob zwei Eintragsbezeichner dasselbe Objekt darstellen, rufen Sie die IMAPISession::CompareEntryIDs-Methode auf.

Wenn ein Client die IMAPIProp::GetProps-Methode eines Objekts aufruft , um den Eintragsbezeichner abzurufen, gibt das Objekt die dauerhaftste Form des Eintragsbezeichners zurück. Ein Client kann überprüfen, ob ein Eintragsbezeichner langfristig ist, indem er überprüft, ob keines der Flags im ersten Byte des abFlags-Elements festgelegt ist.

Wenn ein Client über eine Spalte in einer Tabelle auf einen Eintragsbezeichner zugreift, ist dieser Eintragsbezeichner höchstwahrscheinlich kurzfristig und nicht langfristig. Kurzfristige Eingabebezeichner können verwendet werden, um die entsprechenden Objekte nur in der aktuellen MAPI-Sitzung zu öffnen. Ein Client kann überprüfen, ob ein Eintragsbezeichner kurzfristig ist, indem er überprüft, ob alle Flags im ersten Byte des abFlags-Elements festgelegt sind.

Einige Eintragsbezeichner sind kurzfristig, werden aber langfristig verwendet. Ein solcher Eintragsbezeichner verfügt über mindestens eine der entsprechenden Flags, die im ersten Byte des abFlags-Elements festgelegt sind.

Eine ENTRYID-Struktur ähnelt einer FLATENTRY-Struktur . Es gibt jedoch einige Unterschiede:

Clients sollten immer natürlich ausgerichtete Eingabebezeichner übergeben. Obwohl Anbieter willkürlich ausgerichtete Eintragsbezeichner verarbeiten sollten, sollten Clients dieses Verhalten nicht erwarten. Wenn sie einen gut ausgerichteten Eintragsbezeichner nicht an eine Methode übergeben, kann dies zu einem Ausrichtungsfehler auf RISC-Prozessoren führen.

Der natürliche Ausrichtungsfaktor, in der Regel 8 Byte, ist der größte Datentyp, der von der CPU unterstützt wird, und normalerweise der gleiche Ausrichtungsfaktor, der von der Systemspeicherzuweisung verwendet wird. Eine natürlich ausgerichtete Speicheradresse ermöglicht der CPU den Zugriff auf jeden Datentyp, den sie an dieser Adresse unterstützt, ohne einen Ausrichtungsfehler zu generieren. Bei RISC-CPUs muss ein Datentyp der Größe N Bytes in der Regel an einem geraden Vielfachen von N Bytes ausgerichtet werden, wobei die Adresse ein gerades Vielfaches von N ist.

Weitere Informationen finden Sie unter Eintragsbezeichner.

Siehe auch

FLATENTRY

IMAPISupport::CompareEntryIDs

PidTagRecordKey (kanonische Eigenschaft)

MAPI-Strukturen