功能 XML 元素

本主题中的表描述了 功能 XML 的子元素，并按它们支持的区域进行分组。 每个 功能 元素的默认值为 false。 如果未在 ISocialProvider：：GetCapabilities 方法返回的功能 XML 中指定元素，则元素的值等于 false。

有关 功能 XML 的概述说明，请参阅 XML for Capabilities。 有关 功能 XML 的示例，请参阅 功能 XML 示例。 有关 Microsoft Outlook Social Connector (OSC) 提供程序 XML 架构的完整定义，包括哪些元素是必需的或可选元素，请参阅 Outlook Social Connector Provider XML 架构。

支持好友的功能

下表显示了应用于好友或非好友的任何形式的同步的元素。

元素	说明
doNotFollowPerson	指示提供程序是否支持 ISocialSession：：UnFollowPerson 方法调用。 followPerson 和 doNotFollowPerson 是 OSC 提供程序的独立功能。 OSC 提供商可以指示能够将某人添加为好友的功能， (将 followPerson 设置为 true) ，或者能够将某个人作为好友在社交网络帐户上删除， (将 doNotFollowPerson 设置为 true) 。 通常，能够关注并不意味着能够停止关注。 followPerson 是一种功能，它不会被误解为关注社交网络帐户上的特定人员或每个人的操作。 followPerson 为 true 并不表示 doNotFollowPerson 为 false。
followPerson	指示提供程序是否支持 ISocialSession：：FollowPerson 方法调用。 如果 cacheFriends 为 true (好友) 的缓存同步，dynamicContactsLookup 为 true， (好友和非好友的按需同步) ，或者 cacheFriends 和 dynamicContactsLookup 均为 true， (好友和非好友的混合同步) 。 如果提供程序将 followPerson 设置为 true，则 OSC 在用户关注的人员的“人员”窗格中显示一个网络徽章，并在人员窗格中的“添加 (+) ”菜单上启用 <on NetworkName> 命令。 如果提供程序将 followPerson 设置为 false，则不显示网络锁屏提醒，并且 On <NetworkName> 命令处于隐藏状态。
getFriends	指示提供程序是否支持 ISocialPerson：：GetFriendsAndColleagues 或 ISocialSession2：：GetPeopleDetails 方法调用。 如果提供程序将 getFriends 设置为 true，则 OSC 使用 cacheFriends 或 dynamicContactsLookup 的值来确定社交网络是否允许将好友存储为 Outlook 联系人项目或内存中。 如果提供程序将 getFriends 设置为 false，则社交网络不支持好友和 ISocialPerson：：GetFriendsAndColleagues 和 ISocialSession2：：GetPeopleDetails 方法，OSC 会忽略 cacheFriends 和 dynamicContactsLookup 的值。

以下元素仅适用于好友的缓存同步或好友和非好友的混合同步。 有关同步好友的详细信息，请参阅 同步好友和活动。

元素	说明
cacheFriends	指示 OSC 提供程序是否允许将好友存储为 Outlook 联系人项目。 仅当 getFriends为 true 时，OSC 才会检查 cacheFriends。 如果提供程序将 cacheFriends 设置为 true，则 OSC 通过缓存来同步好友，并在用户的默认存储中为好友联系人创建特定于网络的联系人文件夹。 特定于网络的联系人文件夹的名称是 ISocialProvider：：SocialNetworkName 属性的值。 如果提供程序将 cacheFriends 设置为 false，则 OSC 不会为好友联系人创建特定于网络的联系人文件夹来存储好友。
contactSyncRestartInterval	确定发生同步错误时，尝试从社交网络同步好友信息之间的重试间隔（以分钟为单位）。 仅当 OSC 提供程序支持将好友缓存同步或混合同步到社交网络特定联系人文件夹时，OSC 才使用此元素， (cacheFriends 为 true) 。 默认重试间隔为 30 分钟，除非默认的由 ContactSyncRestartInterval 下的 HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\SocialConnector键重写。 如果提供程序设置 contactSyncRestartInterval，则提供程序值将覆盖默认重试间隔 30 分钟或注册表项值。 有关按需同步好友和非好友信息的详细信息，请参阅 同步好友和活动。

以下元素仅适用于好友和非好友的按需同步或混合同步。

元素	说明
dynamicContactsLookup	指示 OSC 提供程序是否支持 ISocialSession2：：GetPeopleDetails 调用，以便按需同步好友和非好友。 仅当 getFriends为 true 时，OSC 才会检查 dynamicContactsLookup。dynamicContactsLookup 的默认设置为 false。 如果 OSC 提供程序将 dynamicContactsLookup 指定为 true，将 getFriends 指定为 true，则每次刷新人员窗格时，OSC 都会调用 ISocialSession2：：GetPeopleDetails。 当用户在“人员窗格”中选择另一个用户或 Outlook 资源管理器窗口中的另一个项目，或者打开 Outlook 检查器窗口时，将刷新“人员窗格”。 动态联系人查找可确保用户始终在人员窗格中看到最新的用户图片和个人资料信息，但会增加从提供商到社交网络的呼叫数。 如果提供程序将 dynamicContactsLookup 设置为 false，则 OSC 不会调用 ISocialSession2：：GetPeopleDetails 来刷新人员窗格。
showOnDemandContactsWhenMinimized	指示当最小化人员窗格时，OSC 是否应对好友和非好友执行按需同步。

支持活动的功能

以下元素适用于 OSC 提供程序支持的活动的任何形式的同步。

元素	说明
getActivities	指示提供程序是支持 ISocialSession2：：GetActivitiesEx 还是 ISocialPerson：：GetActivities 方法调用。 如果提供程序将 getActivities 设置为 true，则 OSC 使用 cacheActivities 或 dynamicActivitiesLookupEx 的值来确定社交网络网站是否允许将活动存储为 Outlook RSS 项目或内存中活动。 如果提供程序将 getActivities 设置为 false，则社交网络不支持活动和 ISocialSession2：：GetActivitiesEx 和 ISocialPerson：：GetActivities 方法，OSC 将忽略 cacheActivities 和 dynamicActivitiesLookupEx 的值。

以下元素仅适用于活动的缓存同步或混合同步。

元素	说明
cacheActivities	从 Outlook Social Connector 2013 开始，OSC 会忽略此元素，因为提供程序无法再通过将活动缓存在用户存储中的隐藏文件夹中来同步活动。 如果提供程序支持活动，则提供程序必须支持按需同步活动。 提供程序将 cacheActivities 设置为 false ，并将 dynamicActivitesLookupEx 设置为 true。 OSC 按需同步活动，并将活动缓存在内存中。 活动内存缓存每隔 30 分钟刷新一次。

以下元素仅适用于活动的按需同步或混合同步。

元素	说明
dynamicActivitiesLookup	在 OSC 1.1 中已弃用。 从 OSC 1.1 开始，OSC 不再调用 ISocialSession：：GetActivities ，并忽略 dynamicActivitiesLookup 的值。 若要支持按需活动查找，请将 cacheActivities 设置为 false ，将 getActivities 和 dynamicActivitiesLookupEx 设置为 true，OSC 将调用 ISocialSession2：：GetActivitiesEx。
dynamicActivitiesLookupEx	指示 OSC 提供程序是否支持 ISocialSession2：：GetActivitiesEx 调用来按需同步活动。 如果 OSC 提供程序支持按需活动同步，则会将 getActivities 和 dynamicActivitiesLookupEx 设置为 true，并将 cacheActivities 设置为 false。 每次刷新人员窗格时，OSC 都会调用 ISocialSession2：：GetActivitiesEx。 当用户在 Outlook 资源管理器窗口中更改所选项目或打开 Outlook 检查器窗口时，将刷新人员窗格。 动态活动查找可确保用户始终在人员窗格中看到最新活动，但会增加从提供商到社交网络的调用数。 如果提供程序将 dynamicActivitiesLookupEx 设置为 false，则 OSC 不会为人员窗格中显示的人员调用 ISocialSession2：：GetActivitiesEx。
showOnDemandActivitiesWhenMinimized	指示在最小化人员窗格时，OSC 是否应对活动执行按需同步。

用于支持好友、非好友和活动按需或混合同步的常见功能

元素

说明

hashFunction

指定 OSC 提供程序支持的哈希函数。 为了保护不在提供商的社交网络或业务线应用程序上的用户的个人身份信息，OSC 将经过哈希处理的电子邮件地址传递给 ISocialSession2：：GetPeopleDetails 和 ISocialSession2：：GetActivitiesEx。 如果 dynamicContactsLookup 设置为 true 或 dynamicActivitiesLookupEx 设置为 true，则提供程序必须将 hashFunction 设置为允许的值之一： SHA1、 MD5 或 CRC32MD5。 如果 hashFunction 缺失或指定了不正确的值，则 OSC 将返回错误。 SHA1 是由 [RFC3174] 定义的 IETF) 美国安全哈希算法 1 (Internet 工程任务组。 例如，电子邮件地址melissa@contoso.combb81577b567262a21a4df5f6e335c1250acd7b50的 SHA1 哈希值为 。 MD5 是 [RFC1321] 定义的 IETF) MD5 Message-Digest 算法 (Internet 工程任务组。 例如，电子邮件地址melissa@contoso.comc8c39e61ca1662477b39b83d7b0a0615的 MD5 哈希值为 。 CRC32MD5 是 CRC32 和 MD5 的组合，定义如下： 通过删除前导空格和尾随空格并将所有字符转换为小写，使电子邮件地址规范化。 计算规范化电子邮件地址的 CRC32 值，并使用此值的十进制整数表示形式。 如果实现返回有符号整数，则必须将有符号整数转换为无符号整数。 计算规范化电子邮件地址的 MD5 值，并使用此值的十六进制表示形式， (使用小写的 A 到 F) 。 将这两个值与下划线组合在一起。 例如，电子邮件地址melissa@contoso.com2149665315_c8c39e61ca1662477b39b83d7b0a0615的CRC32MD5哈希值为 。

支持身份验证和帐户配置的功能

元素	说明
allowChangesToAutoConfigure	指示社交网络是否允许用户更改自动配置设置，例如提供不同的 URL 以登录。
createAccountUrl	如果提供程序将 hideHyperlinks 设置为 false，当用户在“帐户配置”对话框中单击“单击此处创建帐户”时，createAccountUrl 指定的 URL 将在默认浏览器中打开。
displayUrl	指示 OSC 是否应在帐户配置对话框中显示社交网络的 “URL 地址 ”文本框。
forgotPasswordUrl	如果提供程序将 hideHyperlinks 设置为 false，当用户在“帐户配置”对话框中单击“忘记密码？”时，将在默认浏览器中打开 forgotPasswordUrl 指定的 URL。
hideHyperlinks	指示 OSC 是否应隐藏帐户配置对话框中的 “单击此处创建帐户 ”和 “忘记密码？” 超链接。 OSC 1.0 忽略此设置，并且超链接始终处于隐藏状态。 OSC 1.1 观察此设置的值。
hideRememberMyPassword	指示 OSC 是否应隐藏帐户配置对话框中的“记住我的密码检查”框。 如果提供程序将 hideRememberMyPassword 设置为 true，则 OSC 将像取消选中“ 记住我的密码 ”框一样运行，并且不会保存密码。 如果提供程序将 hideRememberMyPassword 设置为 false，则 OSC 将在帐户配置对话框中显示“记住我的密码检查”框。
supportsAutoConfigure	指示 OSC 是否应在 ISocialProvider 接口上调用 GetAutoConfiguredSession 函数，以尝试自动配置并登录到用户的社交网络。
useLogonCached	指示 OSC 提供程序是否支持使用缓存凭据登录的 ISocialSession2：：LogonCached 调用。 如果提供程序将 useLogonCached 设置为 true，则 OSC 将忽略 useLogonWebAuth 的设置，OSC 调用 ISocialSession2：：LogonCached 进行身份验证。 如果提供程序将 dynamicActivitiesLookupEx 设置为 false，则 OSC 不会调用 ISocialSession2：：LogonCached 进行身份验证。
useLogonWebAuth	指示 OSC 是否应使用基于表单的身份验证和 ISocialSession：：LogonWeb 方法。 如果提供程序将 useLogonWebAuth 设置为 false，则 OSC 使用基本身份验证并调用 ISocialSession：：Logon 方法。 如果提供程序将 useLogonWebAuth 设置为 true，则 OSC 使用基于表单的身份验证并调用 ISocialSession：：LogonWeb。

根据提供程序在 ISocialProvider：：GetCapabilities 方法中返回的功能 XML，帐户配置对话框会更改。 例如，图 1 显示了 TestProvider 示例的帐户配置对话框。

图 1. 帐户配置对话框中的 TestProvider 示例

另请参阅

• XML for Capabilities