操作说明：启用电子邮件通知

  • 项目

重要

2020 年 3 月之前发布的 Microsoft Rights Management Service SDK 版本已弃用;使用早期版本的应用程序必须更新为使用 2020 年 3 月版本。 有关完整详细信息，请参阅 弃用通知。

Microsoft Rights Management Service SDK 没有进一步增强功能。 强烈建议采用用于分类、标记和保护服务的 Microsoft 信息保护 SDK。

受保护的内容所有者通过电子邮件通知可以在其内容受到访问时收到通知。

若要为给定许可证设置电子邮件通知，请将 IpcSetLicenseProperty 与属性类型参数 dwPropID 一起使用 ，IPC_LI_APP_SPECIFIC_DATA格式 的应用程序数据字段设置为 IPC_NAME_VALUE_LIST。

C++：

int numDataPairs = 3;

IPC_NAME_VALUE propertyValuePairs [numDataPairs];

// lcid field set to 0 causes the default lcid to be used

propertyValuePairs[0] = {"MS.Conetent.Name", 0, "FinancialReport.docx"};
propertyValuePairs[1] = {"MS.Notify.Enabled",0 , "true"};
propertyValuePairs[2] = {"MS.Notify.Culture",0 , "en-US"};

IPC_NAME_VALUE_LIST emailNotificationAppData = {numDataPairs, propertyValuePairs};

result = IpcSetLicenseProperty(licenseHandle, FALSE, IPC_LI_APP_SPECIFIC_DATA, emailNotificationAppData);

下表包含用于 RMS 电子邮件通知的应用程序数据字段、属性名称和值对。

属性名称 数据类型 示例值 说明
MS.Content.Name string “FinancialReport.docx” 这是与受保护的内容关联的标识符。

对于受保护的文件，此值应是文件的名称（不包含任何路径信息）。

对于其他类型的内容（如电子邮件），这可能是电子邮件的主题，也可能为空。
MS.Notify.Enabled string “true”|“false” 如果此值设置为“true”，则当有人尝试使用发布许可证来获取最终用户许可证时，会向发布许可证所有者发送通知电子邮件。
MS.Notify.Culture string “en-US” 源： System.Globalization.CultureInfo.CurrentUICulture.Name

此值用于确定通知电子邮件的本地化语言以及应在电子邮件中使用的日期/时间和数字格式设置。

其设置应基于用于创建发布许可证的计算机的用户设置，或基于发布许可证的所有者的首选区域性。
MS.Notify.TZID string “太平洋标准时间” 源： TimeZoneInfo.Local.Id - Windows 时区 ID。

此值用于描述特定时区及其特征的 Microsoft Windows 操作系统时区标识符。
MS.Notify.TZO string “-480” 这是发布许可证所有者的时区相对于 UTC 时间在分钟方面的偏移。

如果提供了有效 TZID 值，则会使用它指定的时区偏移，而忽略此值。

此值很可能由基于非 Windows 的发布平台使用，这些平台无权访问 Windows 操作系统时区 ID 值的列表。

如果未提供 TZID 值，则此值用于计算通知消息的时间偏移，而 TZSN 用于（与时区值无关）指示时区的名称。 这会导致时区固定，不会在夏令时适用时针对夏令时进行更新。

例如：

如果 TXID 为空并且 TZ0 设置为“-420”，而 TZSN 设置为“太平洋标准时间”，则通知电子邮件中显示的所有值都会调整为“太平洋标准时间”，即使夏令时当前已不再生效也会显示为这样。

另一方面，如果随 TZSN 和 TZDN 一起提供了 TZID，则通知电子邮件中指定的时间会基于日期和时间应以夏令时模式还是标准模式来显示而进行调整和显示。
MS.Notify.TZSN string “太平洋标准时间” 源： TimeZoneInfo.Local.StandardName - 标准时区名称。

这应是时区标准时区名称的本地化名称。
MS.Notify.TZDN string “太平洋夏令时” 源： TimeZoneInfo.Local.DaylightName - 夏令时时区名称。

这应是时区夏令时名称的本地化名称。 如果时区不支持夏令时，则它可能与标准名称相同。