PidTagDisplayTypeEx (kanonische Eigenschaft)

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Enthält den Typ eines Eintrags in Bezug darauf, wie der Eintrag in einer Zeile in einer Tabelle für die globale Adressliste angezeigt werden soll.

Eigenschaft	Wert
Zugeordnete Eigenschaften:	PR_DISPLAY_TYPE_EX
Kennung:	0x3905
Datentyp:	PT_LONG
Bereich:	MAPI-Adressbuch

Hinweise

Diese Eigenschaft gibt den Typ eines Eintrags in Bezug darauf an, wie er in der globalen Adressliste angezeigt werden soll. Sie stellt zusätzliche Informationen bereit, die in PR_DISPLAY_TYPE (PidTagDisplayType) nicht dargestellt werden können.

Hinweis

Die Werte von PR_DISPLAY_TYPE und dieser Eigenschaft beginnen mit "DT_" und werden in Mapitags.h definiert. Alle nicht dokumentierten Werte sind für MAPI reserviert. Clientanwendungen dürfen keine neuen Werte definieren und müssen darauf vorbereitet sein, mit einem nicht dokumentierten Wert umzugehen.

Es gibt einige Makros, mit denen Attribute eines Objekts bestimmt werden können, z. B. ob es lokal, remote oder sicherheitsgesteuert ist. Zu diesen Makros gehören:

Makro	Wert
DTE_FLAG_REMOTE_VALID	0x80000000)
DTE_FLAG_ACL_CAPABLE	0x40000000
DTE_MASK_REMOTE	0x0000ff00
DTE_MASK_LOCAL	0x000000ff
DTE_IS_REMOTE_VALID(v)	(!! (v) & DTE_FLAG_REMOTE_VALID)
DTE_IS_ACL_CAPABLE(v)	(!! (v) & DTE_FLAG_ACL_CAPABLE))
DTE_REMOTE(v)	((v) & DTE_MASK_REMOTE) >> 8)
DTE_LOCAL(v)	(v) & DTE_MASK_LOCAL)
DT_ROOM	((ULONG) 0x00000007)
DT_EQUIPMENT	((ULONG) 0x00000008)
DT_SEC_DISTLIST	((ULONG) 0x00000009)

Im Folgenden finden Sie einige Hinweise zur Verwendung dieser Makros.

Um zu überprüfen, ob es sich bei einem Eintrag um einen Remoteeintrag in einer anderen Gesamtstruktur handelt, wenden Sie das makro DTE_IS_REMOTE_VALID auf den Wert dieser Eigenschaft an, um zu überprüfen, ob das DTE_FLAG_REMOTE_VALID-Flag im Eintrag festgelegt ist. Wenn es sich um einen Remoteeintrag handelt, können Sie den Typ des Remoteeintrags mithilfe des makros DTE_REMOTE ermitteln.
Wenn PR_DISPLAY_TYPE den Wert DT_DISTLIST hat und DTE_IS_REMOTE_VALID false ist, können Sie durch Anwenden des Makros DTE_LOCAL auf den Wert dieser Eigenschaft den Typ des Objekts als DT_DISTLIST (Verteilerliste) oder als DT_SEC_DISTLIST (Sicherheitsverteilerliste) weiter identifizieren.
Wenn Sie das Makro DTE_LOCAL auf den Wert von PR_DISPLAY_TYPE_EX anwenden und den Typ DT_REMOTE_MAILUSER zurückgeben, ist der Eintrag ein Remoteeintrag.
In einer einzelnen Gesamtstruktur oder in einer gesamtstrukturübergreifenden Konfiguration, bei der die Replikation durch eine Access Control List (ACL) gesteuert wird, können Sie das makro DTE_IS_ACL_CAPABLE verwenden, um zu bestimmen, ob ein Eintrag ein Sicherheitsprinzipal ist.

In einer gesamtstrukturübergreifenden Konfiguration weist PR_DISPLAY_TYPE den Wert DT_REMOTE_MAILUSER auf. Wenn Sie das Makro DTE_REMOTE auf den Wert dieser Eigenschaft anwenden, können Sie den Typ des Remoteeintrags abrufen. Die folgenden Arten von Remoteeingaben sind möglich:

Typ der Remoteeingabe	Wert	Beschreibung
DT_AGENT	((ULONG) 0x00000003)	Dynamische Verteilerliste:
DT_DISTLIST	((ULONG) 0x00000001)	Verteilerliste:
DT_EQUIPMENT	((ULONG) 0x00000008)	Ausrüstung, z. B. ein Drucker oder ein Projektor.
DT_MAILUSER	((ULONG) 0x00000000)	Benutzer mit einem Postfach.
DT_REMOTE_MAILUSER	((ULONG) 0x00000000)	Ein Adresslisteneintrag in der globalen Adressliste.
DT_ROOM	((ULONG) 0x00000007)	Konferenzraum.
DT_SEC_DISTLIST	((ULONG) 0x00000009)	Sicherheitsverteilerliste.

Wenn PR_DISPLAY_TYPE sowohl in einer einzelnen Gesamtstruktur als auch in einer gesamtstrukturübergreifenden Konfiguration den Wert DT_DISTLIST hat und DTE_IS_REMOTE_VALID false ist, können Sie den Typ der Verteilerliste durch Anwenden des makros DTE_LOCAL auf den Wert dieser Eigenschaft abrufen. Folgende Arten von Verteilerlisten sind möglich: