Habilitación de la notificación por correo electrónico
Importante
Las versiones del SDK del servicio Microsoft Rights Management publicadas antes de marzo de 2020 están en desuso; Las aplicaciones que usan versiones anteriores deben actualizarse para usar la versión de marzo de 2020. Para obtener información completa, consulte el aviso de desuso.
No se planean mejoras adicionales para el SDK de Microsoft Rights Management Service. Se recomienda encarecidamente la adopción del SDK de Microsoft Information Protection para los servicios de clasificación, etiquetado y protección.
Las notificaciones de correo electrónico avisan al propietario de contenido protegido si alguien tiene acceso a su contenido.
Para configurar la notificación por correo electrónico de una licencia determinada, use IpcSetLicenseProperty con el parámetro de tipo de propiedad dwPropID, como IPC_LI_APP_SPECIFIC_DATA y los campos de datos de la aplicación con formato de 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);
La siguiente tabla contiene los campos de datos de la aplicación y los pares de nombre y valor de propiedad correspondientes a la notificación de correo electrónico de RMS.
| Nombre de propiedad | Tipo de datos | Valor de ejemplo | Notas |
|---|---|---|---|
| MS.Content.Name | string | “FinancialReport.docx” | Se trata de un identificador asociado con el contenido protegido. Para archivos protegidos, este valor debe ser el nombre del archivo sin información de ruta de acceso. Para otros tipos de contenido, como un mensaje de correo electrónico, podría ser el asunto del correo electrónico o podría estar vacío. |
| MS.Notify.Enabled | string | | "true" "false" | Si este valor se establece en “true”, el propietario de la licencia de publicación recibirá una notificación de correo electrónico cuando un usuario intente usarla para obtener una licencia de usuario final. |
| MS.Notify.Culture | string | “en-US” | Origen: System.Globalization.CultureInfo.CurrentUICulture.Name Este valor se usa para determinar el idioma del correo electrónico de notificación, así como el formato de fecha, hora y número que debe usarse en el mensaje de correo electrónico. Debe establecerse en función de la configuración establecida por el usuario de la máquina en la que se crea la licencia de publicación o en función de la referencia cultural preferida del propietario de la licencia de publicación. |
| MS.Notify.TZID | string | “Pacific Standard Time” | Origen: TimeZoneInfo.Local.Id - Identificador de zona horaria de Windows. Este valor es el identificador de zona horaria del sistema operativo Microsoft Windows que describe una zona horaria determinada y sus características. |
| MS.Notify.TZO | string | “-480” | Se trata del desplazamiento de zona horaria del propietario de la licencia de publicación expresado minutos y con respecto a la hora UTC. Si se proporciona un valor válido de TZID, se usará el desplazamiento de la zona horaria especificada por él y se omitirá este valor. Este valor será el que con toda probabilidad usen aquellas plataformas de publicación que no estén basadas en Windows y que, por tanto, no tengan acceso a la lista de valores de identificador de zona horaria del sistema operativo Windows. Si no se proporciona un valor TZID, se usará este valor para calcular el desplazamiento horario de los mensajes de notificación, mientras que el TZSN se usará (independientemente del valor de zona horaria) para indicar el nombre de la zona horaria. Esto provocará que la zona horaria sea fija y no se actualice con el horario de verano. Por ejemplo: Si TXID está en blanco, TZ0 se configura en “-420” y el valor de TZSN se establece en “Pacific Daylight Time”, entonces todos los valores mostrados en el correo electrónico de notificación se ajustarán a esa zona horaria y se mostrarán aunque el horario de verano ya no esté en vigor. Por otra parte, si se proporciona un valor de TZID junto con TZSN y TZDN, las horas especificadas en el correo electrónico de notificación se ajustarán y se mostrarán en función de si la fecha y hora deben mostrarse en modo de verano o en modo estándar. |
| MS.Notify.TZSN | string | “Pacific Standard Time” | Origen: TimeZoneInfo.Local.StandardName - Nombre de la zona horaria estándar. Este debe el nombre localizado de la zona horaria estándar. |
| MS.Notify.TZDN | string | “Pacific Daylight Time” | Origen: TimeZoneInfo.Local.DaylightName - Nombre de la zona horaria del horario de verano. Este debe ser el nombre localizado del horario de verano de la zona horaria. Puede ser el mismo que el nombre estándar si la zona horaria no admite horario de verano. |