如何：啟用電子郵件通知
重要
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 | 字串 | “FinancialReport.docx” | 這是與受保護內容相關聯的識別碼。 受保護檔案的這個值應該是檔案的名稱，不含任何路徑資訊。 其他類型內容 (例如電子郵件訊息) 的這個值則可能是電子郵件的主旨或可能是空的。 |
| MS.Notify.Enabled | string | 「true」 |「false」 | 如果此值設定為"true"，當有人嘗試使用它來取得使用者授權時，系統會傳送通知電子郵件給發行授權的擁有者。 |
| MS.Notify.Culture | 字串 | “en-US” | 來源： System.Globalization.CultureInfo.CurrentUICulture.Name 這個值用來判斷通知電子郵件的當地語系化的語言，以及電子郵件訊息中應使用的日期/時間和數字格式。 它應該會根據建立發行授權之電腦上的使用者設定而設定，或根據發行授權擁有者的慣用文化而設定。 |
| MS.Notify.TZID | string | “Pacific Standard Time” | 來源︰ TimeZoneInfo.Local.Id - Windows time zone ID. 這個值是 Microsoft Windows 作業系統的時區識別碼，描述特定時區及其特性。 |
| MS.Notify.TZO | 字串 | “-480” | 這是發行授權擁有者的時區位移，為與 UTC 的時間差 (分鐘)。 若有提供有效的 TZID 值，統將使用其指定的時區位移系，忽略這個值。 非 Windows 發行平台很可能會使用此值，因其無法存取 Windows 作業系統的時區識別碼值清單。 如未提供 TZID 值，會用這個值來計算通知訊息的時間位移，TZSN 則用於 (不管時區值為何) 表示時區的名稱。 這會導致固定的時區，不會針對日光節約時間更新。 例如： 如果 TXID 空白，且 TZ0 設為 -420、 TZSN 設為 "Pacific Daylight Time"，通知電子郵件中的所有值會調整為「太平洋日光節約時間」並如此顯示，即使目前不是過日光節約時間。 另一方面，如果同時提供 TZID 以及 TZSN 和 TZDN，則會根據日期和時間應該以日光節約模式或標準模式顯示，來調整並顯示電子郵件通知中的時間。 |
| MS.Notify.TZSN | 字串 | “Pacific Standard Time” | 來源： TimeZoneInfo.Local.StandardName - Standard Time Zone name. 這應該是時區的標準時區名稱的當地語系化名稱。 |
| MS.Notify.TZDN | 字串 | “Pacific Daylight Time” | 來源： TimeZoneInfo.Local.DaylightName - Daylight Time Zone name. 這應該是時區的日光節約名稱的當地語系化名稱。 如果時區不支援日光節約時間，它可能和標準名稱相同。 |