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:
Eine ENTRYID-Struktur speichert nicht die Größe des Eintragsbezeichners. eine FLATENTRY-Struktur hat dies.
Eine ENTRYID-Struktur speichert die Flagdaten und den Rest des Eintragsbezeichners separat. eine FLATENTRY-Struktur speichert die Flagdaten mit dem Rest des Eintragsbezeichners.
Eine ENTRYID-Struktur wird als Parameter an die Methoden der IMAPIProp-Schnittstelle und an die folgenden OpenEntry-Methoden übergeben: IABLogon::OpenEntry, IAddrBook::OpenEntry, IMAPIContainer::OpenEntry, IMAPISession::OpenEntry, IMAPISupport::OpenEntry, IMsgStore::OpenEntry, IMSLogon::OpenEntry
Eine ENTRYID-Struktur wird verwendet, um einen Eintragsbezeichner auf dem Datenträger zu speichern. Eine FLATENTRY-Struktur wird verwendet, um einen Eintragsbezeichner in einer Datei zu speichern oder in einem Bytestream zu übergeben.
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.