Comment : activer les notifications par e-mail
Important
Les versions du Kit de développement logiciel (SDK) du service Microsoft Rights Management publiées avant mars 2020 sont déconseillées ; les applications utilisant des versions antérieures doivent être mises à jour pour utiliser la version de mars 2020. Pour plus d’informations, consultez l’avis de dépréciation.
Aucune autre amélioration n’est prévue pour le Kit de développement logiciel (SDK) du service Microsoft Rights Management. Nous vous recommandons vivement d’adopter le KIT de développement logiciel (SDK) Protection des données Microsoft pour les services de classification, d’étiquetage et de protection.
Les notifications par e-mail permettent à un propriétaire de contenu protégé d’être averti quand un utilisateur accède à son contenu.
Pour configurer votre notification par e-mail pour une licence donnée, utilisez IpcSetLicenseProperty avec le paramètre de type de propriété , dwPropID, comme IPC_LI_APP_SPECIFIC_DATA et les champs de données de l’application mis en forme en tant que 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);
Le tableau suivant contient les champs de données de l’application (les paires nom/valeur des propriétés) pour les e-mails de notification RMS.
| Nom de la propriété | Type de données | Exemple de valeur | Notes |
|---|---|---|---|
| MS.Content.Name | string | « FinancialReport.docx » | Il s’agit d’un identificateur associé au contenu protégé. Pour les fichiers protégés, cette valeur doit être le nom du fichier, sans les informations de chemin. Pour les autres types de contenu, par exemple, les e-mails, cette valeur peut correspondre à l’objet de l’e-mail ou bien être vide. |
| MS.Notify.Enabled | string | | « true » « false » | Si cette valeur est définie sur « true », un e-mail de notification est envoyé au propriétaire de la licence de publication quand un utilisateur tente d’utiliser sa licence pour obtenir une licence utilisateur final. |
| MS.Notify.Culture | string | « en-US » | Source : System.Globalization.CultureInfo.CurrentUICulture.Name Cette valeur est utilisée pour déterminer la langue localisée de l’e-mail de notification, ainsi que le format de date et d’heure qui doit être utilisé dans l’e-mail. Elle doit être définie selon les paramètres utilisateur de l’ordinateur sur lequel est créée la licence de publication, ou selon la culture par défaut du propriétaire de la licence de publication. |
| MS.Notify.TZID | string | « Pacific Standard Time » | Source : TimeZoneInfo.Local.Id - ID de fuseau horaire Windows. Cette valeur correspond à l’identificateur de fuseau horaire du système d’exploitation Microsoft Windows qui décrit un fuseau horaire particulier et ses caractéristiques. |
| MS.Notify.TZO | string | « -480 » | Il s’agit du décalage horaire du propriétaire de la licence de publication, exprimé en minutes, par rapport à l’heure UTC. Si une valeur TZID est fournie, le décalage du fuseau horaire spécifié sera utilisé et cette valeur sera ignorée. Cette valeur sera probablement utilisée par les plateformes de publication non Windows qui n’ont pas accès à la liste des valeurs d’ID de fuseau horaire du système d’exploitation Windows. Si aucune valeur TZID n’est fournie, cette valeur sera utilisée pour calculer le décalage des messages de notification et la valeur TZSN sera utilisée (quelle que soit la valeur de fuseau horaire) pour indiquer le nom du fuseau horaire. De cette manière, le fuseau horaire reste fixe et n’est pas mis à jour à l’heure d’été. Par exemple : Si la valeur TXID est vide, et si la valeur TZ0 est définie sur « -420 » et la valeur TZSN définie sur « Pacific Daylight Time », toutes les valeurs indiquées dans l’e-mail de notification seront ajustées à l’heure « Pacific Daylight Time » et le resteront, même si l’heure d’été n’est plus en cours. En revanche, si une valeur TZID est fournie, ainsi qu’une valeur TZSN et une valeur TZDN, les heures spécifiées dans l’e-mail de notification seront ajustées et s’afficheront selon le mode d’affichage de date et d’heure défini (Heure d’été ou Standard). |
| MS.Notify.TZSN | string | « Pacific Standard Time » | Source : TimeZoneInfo.Local.StandardName - Nom du fuseau horaire. Cela doit correspondre au nom localisé du fuseau horaire Standard. |
| MS.Notify.TZDN | string | « Pacific Daylight Time » | Source : TimeZoneInfo.Local.DaylightName - Nom du fuseau horaire de l’heure d’été. Cela doit correspondre au nom localisé du fuseau horaire de l’heure d’été. Il peut être le même que le nom standard si le fuseau horaire ne prend pas en charge l’heure d’été. |