PidTagDisplayTypeEx 规范属性

适用于:Outlook 2013 | Outlook 2016

包含条目的类型,该条目应如何显示在全局地址列表的表中的行中。

属性
相关属性:
PR_DISPLAY_TYPE_EX
标识符:
0x3905
数据类型:
PT_LONG
区域:
MAPI 通讯簿

备注

此属性指定条目的类型,它应如何显示在全局地址列表中。 它提供无法在 PR_DISPLAY_TYPE (PidTagDisplayType) 中表示的其他信息。

注意

PR_DISPLAY_TYPE 和此属性的值都以“DT_”开头,并在 Mapitags.h 中定义。 所有未记录的值都为 MAPI 保留。 客户端应用程序不得定义任何新值,并且必须准备好处理未记录的值。

有一些宏可以帮助确定对象的属性,例如它是本地、远程还是安全控制。 这些宏包括:

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)

下面是有关如何使用这些宏的一些说明。

  • 若要检查某个条目是否是另一个林中的远程条目,请将 DTE_IS_REMOTE_VALID 宏应用于此属性的值,以检查是否在条目中设置了DTE_FLAG_REMOTE_VALID标志。 如果是远程条目,则可以使用 DTE_REMOTE 宏找出该远程条目的类型。

  • 在单林和跨林配置中, 当PR_DISPLAY_TYPE 的值为DT_DISTLIST且DTE_IS_REMOTE_VALID为 false 时,将宏DTE_LOCAL应用于此属性的值,可以进一步将对象的类型标识为DT_DISTLIST (通讯组列表) 或DT_SEC_DISTLIST (安全通讯组列表) 。

  • 如果将宏DTE_LOCAL应用于 PR_DISPLAY_TYPE_EX 的值,并且它返回类型DT_REMOTE_MAILUSER,则该条目是一个远程条目。

  • 在单林或跨林配置中,复制由 访问控制 List (ACL) 控制,可以使用 DTE_IS_ACL_CAPABLE 宏来确定条目是否为安全主体。

在跨林配置中, PR_DISPLAY_TYPE 的值为 DT_REMOTE_MAILUSER。 将宏DTE_REMOTE应用于此属性的值可以获取远程条目的类型。 远程条目的可能类型如下:

远程条目的类型 说明
DT_AGENT
((ULONG) 0x00000003)
动态通讯组列表。
DT_DISTLIST
((ULONG) 0x00000001)
通讯组列表。
DT_EQUIPMENT
( (ULONG) 0x00000008)
设备,例如打印机或投影仪。
DT_MAILUSER
( (ULONG) 0x00000000)
具有邮箱的用户。
DT_REMOTE_MAILUSER
( (ULONG) 0x00000000)
全局地址列表中的地址列表条目。
DT_ROOM
( (ULONG) 0x00000007)
会议室。
DT_SEC_DISTLIST
( (ULONG) 0x00000009)
安全通讯组列表。

在单个林和跨林配置中,当 PR_DISPLAY_TYPE 的值为 DT_DISTLIST 且 DTE_IS_REMOTE_VALID 为 false 时,将 DTE_LOCAL 宏应用于此属性的值可让你获取通讯组列表的类型。 通讯组列表的可能类型如下:

通讯组列表的类型 说明
DT_DISTLIST
((ULONG) 0x00000001)
通讯组列表。
DT_SEC_DISTLIST
( (ULONG) 0x00000009)
安全通讯组列表。

协议规范

[MS-OXPROPS]

提供对相关Exchange Server协议规范的引用。

[MS-OXOABK]

指定用户、联系人、组和资源列表的属性和操作。

头文件

Mapidefs.h

提供数据类型定义。

Mapitags.h

包含作为备用名称列出的属性的定义。

另请参阅

MAPI 属性

MAPI 规范属性

将规范属性名称映射到 MAPI 名称

将 MAPI 名称映射到规范属性名称