Dela via


Anvisningar: Aktivera e-postavisering

Viktigt

Versioner av Microsoft Rights Management Service SDK som släpptes före mars 2020 är inaktuella. program som använder tidigare versioner måste uppdateras för att använda versionen från mars 2020. Fullständig information finns i utfasningsmeddelandet.

Inga ytterligare förbättringar planeras för Microsoft Rights Management Service SDK. Vi rekommenderar starkt att du använder Microsoft Information Protection SDK för klassificering, etikettering och skyddstjänster.

E-postaviseringen gör det möjligt för den som är ägare till skyddat innehåll att få en avisering när någon kommer åt personens innehåll.

Om du vill konfigurera e-postaviseringen för en viss licens använder du IpcSetLicenseProperty med parametern egenskapstyp, dwPropID, som IPC_LI_APP_SPECIFIC_DATA och programdatafälten formaterade som en 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);

Följande tabell innehåller programdatafält, egenskapsnamn och värdepar för e-postaviseringar från RMS.

Egenskapens namn Datatyp Exempelvärde Kommentarer
MS.Content.Name sträng ”FinancialReport.docx” Det här är en identifierare som är kopplad till det skyddade innehållet.

För skyddade filer bör detta värde vara namnet på filen utan att någon information om sökvägen.

För andra typer av innehåll, till exempel ett e-postmeddelande, kan det vara e-postmeddelandets ämnesrad eller vara tomt.
MS.Notify.Enabled sträng "sant" | "false" Om det här värdet är inställt på ”true” skickas en avisering via e-post till ägaren av publiceringslicensen när någon försöker använda den för att skaffa en slutanvändarlicens.
MS.Notify.Culture sträng ”en-US” Källa: System.Globalization.CultureInfo.CurrentUICulture.Name

Det här värdet används för att fastställa det lokaliserade språket för e-postaviseringen och datum/tid och talformat som ska användas i e-postmeddelandet.

Det ska ställas in baserat på användarinställningarna för den dator som publiceringslicensen skapas på, eller baserat på den önskade kulturen för ägaren av publiceringslicensen.
MS.Notify.TZID sträng ”Pacific Standard Time” Källa: TimeZoneInfo.Local.Id – Windows tidszons-ID.

Det här värdet är den tidszonsidentifierare i Microsoft Windows-operativsystemet som beskriver en viss tidszon och dess egenskaper.
MS.Notify.TZO sträng ”-480” Den här är den publicerade licensägarens tidszonsförskjutning räknat i minuter från UTC-tid.

Om det finns ett giltigt värde för TZID används den förskjutning av tidszonen som anges av den och det här värdet ignoreras.

Det är mycket sannolikt att det här värdet kommer att användas av icke-Windows-baserade publiceringsplattformar som inte har tillgång till listan över ID-värden för Windows-operativsystemets tidszoner.

Om ett TZID-värde inte tillhandahålls används detta värde för att beräkna tidsförskjutningen i aviseringsmeddelanden och TZSN används (oavsett tidszonsvärdet) för att ange namnet på tidszonen. Detta leder till att tidszonen blir fast och inte uppdateras för sommartid när det är aktuellt.

Ett exempel:

Om TXID är tomt och TZ0 är inställd på ”-420” och TZSN anges till ”Pacific Daylight Time” kommer alla värden som visas i e-postmeddelandet med aviseringen att justeras till ”Pacific Daylight Time” och visas så även om sommartid inte råder för närvarande.

Å andra sidan, om ett TZID har angetts tillsammans med både TZSN och TZDN, och justeras de tider som anges i e-postmeddelandet med aviseringen och visas baserat på om datum och klockslag ska visas i sommartidsläge eller normaltidsläge.
MS.Notify.TZSN sträng ”Pacific Standard Time” Källa: TimeZoneInfo.Local.StandardName – namn på standardtidszon.

Det här bör vara det lokaliserade namnet på tidszonens normaltidszonsnamn.
MS.Notify.TZDN sträng ”Pacific Daylight Time” Källa: TimeZoneInfo.Local.DaylightName – namn på sommartidszon.

Detta bör vara det lokaliserade namnet för tidszonens sommartidsnamn. Det kan vara detsamma som standardnamnet om tidszonen inte har stöd för sommartid.