Postupy: Povolení e-mailových oznámení
Důležité
Verze sady MICROSOFT Rights Management Service SDK vydané před březnem 2020 jsou zastaralé; aplikace používající starší verze musí být aktualizovány tak, aby používaly verzi z března 2020. Úplné podrobnosti najdete v oznámení o vyřazení.
Pro sadu MICROSOFT Rights Management Service SDK se neplánují žádná další vylepšení. Důrazně doporučujeme přijmout sadu Microsoft Information Protection SDK pro klasifikaci, označování a služby ochrany.
E-mailová oznámení umožňují nastavit upozornění vlastníka chráněného obsahu na přístup k jeho obsahu.
Pokud chcete nastavit e-mailové oznámení pro danou licenci, použijte IpcSetLicenseProperty s parametrem typu vlastnosti, dwPropID, jako IPC_LI_APP_SPECIFIC_DATA a datová pole aplikace formátovaná jako 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);
Následující tabulka uvádí datová pole aplikace, dvojici názvu vlastnosti a hodnoty pro e-mailová oznámení RMS.
Název vlastnosti | Typ dat | Příklad hodnoty | Poznámky |
---|---|---|---|
MS.Content.Name | řetězec | FinancialReport.docx | Toto je identifikátor přidružený k chráněnému obsahu. Pro chráněné soubory by tato hodnota měla být název souboru bez jakýchkoli informací o cestě. Pro jiné typy obsahu, jako jsou například e-mailové zprávy, to může být předmět e-mailu. Taky může být prázdná. |
MS.Notify.Enabled | řetězec | "true" | "false" | Pokud je tato hodnota nastavená na true, e-mailové oznámení se odešle vlastníkovi licence pro publikování, když se někdo pokusí ji použít k získání licence koncového uživatele. |
MS.Notify.Culture | řetězec | cs-CZ | Zdroj: System.Globalization.CultureInfo.CurrentUICulture.Name Tato hodnota se používá k určení lokalizovaného jazyka e-mailových oznámení a formátování data/času a čísla, které by se mělo používat v e-mailové zprávě. Mělo by být nastavené na základě uživatelského nastavení počítače, na kterém je vytvořená publikovaná licence, nebo na základě upřednostňované jazykové verze vlastníka licence pro publikování. |
MS.Notify.TZID | řetězec | Tichomoří (běžný čas) | Zdroj: TimeZoneInfo.Local.Id - Windows time zone ID. Tato hodnota označuje identifikátor časového pásma operačního systému Microsoft Windows popisující konkrétní časové pásmo a jeho vlastnosti. |
MS.Notify.TZO | řetězec | “-480” | Toto je posunutí oproti časovému pásmu vlastníka licence pro publikování od času UTC v minutách. Pokud je zadaná platná hodnota TZID, použije se posunutí oproti časovému pásmu, které specifikuje a hodnota se bude ignorovat. Tuto hodnotu budou s největší pravděpodobností používat šablony pro publikování jiných platforem než Window, které nemají přístup k seznamu hodnot ID časových pásem operačního systému Windows. Pokud hodnota TZID není zadaná, použije se tato hodnota k výpočtu časového posunu v oznamovacích zprávách a TZSN bude sloužit (bez ohledu na hodnotu časového pásma) k označení názvu časového pásma. Ve výsledku se časové pásmo opraví a nebude se aktualizovat podle letního času tam, kde se používá. Příklad: Pokud je pole TXID prázdné a v poli TZ0 je nastavená hodnota -420 a v poli TZSN Tichomoří (běžný čas), všechny hodnoty v e-mailu s oznámení se upraví na Tichomoří (běžný čas) a budou se tak zobrazovat, i když už není aktuálně ovlivněný letní čas. Pokud je ale naopak TZID zadaný s hodnotou TZSN i TZDN, časy specifikované v e-mailu s oznámením se upraví a budou se zobrazovat bez ohledu na to, jestli se datum a čas budou zobrazovat v režimu letního času nebo standardním režimu. |
MS.Notify.TZSN | řetězec | Tichomoří (běžný čas) | Zdroj: TimeZoneInfo.Local.StandardName – název standardního časového pásma. To by měl lokalizovaný název názvu standardního časového pásma pro dané časové pásmo. |
MS.Notify.TZDN | řetězec | Tichomoří (letní čas) | Zdroj: TimeZoneInfo.Local.DaylightName – Název časového pásma pro letní čas. To by měl být lokalizovaný název letního času časového pásma. Pokud dané časové pásmo nepodporuje letní čas, může být stejný jako běžný název. |