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 流结构

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

此结构中的数据元素按小字节顺序存储,按照以下指定顺序紧跟彼此。

备注

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

dwVersion

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

值名称
WEBVIEW_PERSISTENCE_VERSION
0x00000002

dwType

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

值名称
WEBVIEWURL
0x00000001

dwFlags

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

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

dwUnused[7]

一个由 7 个 DWORD 元素组成的数组 (总) 28 个字节。 闲置。

cbData

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

wzURL

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

WebViewPersistenceObject 流示例

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

数据转储

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

流偏移量 数据字节 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”。