PidTagFolderWebViewInfo 规范属性

适用于:Outlook 2013 | Outlook 2016

包含 Microsoft Outlook 中文件夹主页的 URL。 此属性包含名为 WebViewPersistenceObject 的二进制流。

属性
相关属性:
PR_FOLDER_WEBVIEWINFO
标识符:
0x36DF
数据类型:
PT_BINARY
区域:
MAPI 文件夹

备注

可以为任何 Outlook 文件夹指定主页 URL。 可以在 Outlook 中从文件夹的“属性”对话框的“ 主页 ”选项卡访问此信息。

根据某些策略设置,如果包含此文件夹的 MAPI 存储不在其 IMSCapabilities::GetCapabilities 实现中报告MSCAP_SECURE_FOLDER_HOMEPAGES,Outlook 可能会忽略主页。

Outlook Today 文件夹和公用文件夹都可以具有主页 URL。 但是, Outlook Today 文件夹使用不同的机制来管理其主页 URL;本主题未介绍该机制。 公用文件夹中可能还定义了特定于用户的主页 URL。 但是,本主题中未介绍该功能。

此属性的值是名为 WebViewPersistenceObject 的二进制流。

WebViewPersistenceObject Stream 结构

WebViewPersistenceObject 流结构包含有关文件夹的主页 URL 的信息。

此结构中的数据元素以 little-endian 字节顺序存储,并按以下指定顺序紧随其后。

注意

以下说明可能不会列出 Outlook 支持的所有字段值:因此,当代码读取现有流时,可能还会找到一些此处未列出的标志。 但是,可以使用此说明以编程方式为 Outlook 可理解的 PidTagFolderWebViewInfo 属性创建值。

dwVersion

) DWORD (4 个字节。 结构格式的版本。 从 Microsoft Office Outlook 2007 开始,此字段唯一支持的值如下所示。

值名称
WEBVIEW_PERSISTENCE_VERSION
0x00000002

dwType

) DWORD (4 个字节。 主页信息的类型。 从 Microsoft Office Outlook 2007 开始,此字段唯一支持的值如下所示。

值名称
WEBVIEWURL
0x00000001

dwFlags

) DWORD (4 个字节。 下表中列出了其值和含义的零个或多个标志的组合。

标志名称 说明
WEBVIEW_FLAGS_SHOWBYDEFAULT
0x00000001
在文件夹的“属性”对话框的“主页”选项卡中选中了“默认显示此文件夹的主页检查”框。

dwUnused[7]

包含 7 个 DWORD 元素的数组, (总) 28 个字节。 闲置。

cbData

ULONG (4 个字节) 。 wzURL 数据元素的大小(以字节为单位)。

wzURL

WCHAR 元素的数组。 以零结尾的主页 URL 字符串的 UTF-16 表示形式。

WebViewPersistenceObject Stream 示例

本部分介绍 WebViewPersistenceObject 流的示例。 流指定主页 URL “https://www.microsoft.com"。

数据转储

下面是流在二进制编辑器中显示的数据转储。

Stream偏移量 数据字节 ASCII 数据
0000000000
02 00 00 00 01 00 00 00 01 00 00 00 00 00 00 00
?...?...?.......
0000000010
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
................
0000000020
00 00 00 00 00 00 00 00 32 00 00 00 68 00 74 00
........2...h.t.
0000000030
74 00 70 00 3A 00 2F 00 2F 00 77 00 77 00 77 00
t.p.:././.w.w.w.
0000000040
2E 00 6D 00 69 00 63 00 72 00 6F 00 73 00 6F 00
..m.i.c.r.o.s.o.
0000000050
66 00 74 00 2E 00 63 00 6F 00 6D 00 00 00
f.t...c.o.m...

下面是 WebViewPersistenceObject 流的示例数据分析。

dwVersion

偏移0x0,4 个字节:0x00000002 (WEBVIEW_PERSISTENCE_VERSION) 。

dwType

偏移0x4,4 个字节:0x00000001 (WEBVIEWURL) 。

dwFlags

偏移0x8,4 个字节:0x00000001 (WEBVIEW_FLAGS_SHOWBYDEFAULT) 。

dwUnused[7]

偏移0xC,28 个字节:所有零。

cbData

偏移0x28,4 个字节:0x00000032。

wzURL

偏移0x2C,0x32个字节:25 个 WCHAR 的数组。 以零结尾的 Unicode 字符串值:“https://www.microsoft.com"。