方法: 電子メール通知の有効化
重要
2020 年 3 月より前にリリースされた Microsoft Rights Management Service SDK のバージョンは非推奨です。2020 年 3 月のリリースを使用するには、以前のバージョンを使用するアプリケーションを更新する必要があります。 詳細については、 非推奨の通知を参照してください。
Microsoft Rights Management Service SDK の今後の機能強化は計画されていません。 分類、ラベル付け、保護サービスには、Microsoft Information Protection SDK の導入を強くお勧めします。
電子メール通知を使用すると、保護されたコンテンツがアクセスされたたときに、そのコンテンツの所有者に通知することができます。
特定のライセンスの電子メール通知を設定するには、プロパティ型パラメーター dwPropID をIPC_LI_APP_SPECIFIC_DATAとして IpcSetLicenseProperty を使用し、アプリケーション データ フィールドを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 | string | “FinancialReport.docx” | 保護されたコンテンツに関連付けられている識別子です。 保護されたファイルでは、この値はパス情報がないファイルの名前にする必要があります。 電子メール メッセージなどの他の種類のコンテンツでは、電子メールの件名であったり、空であったりする場合もあります。 |
| MS.Notify.Enabled | string | "true" |"false" | この値を "true" にすると、だれかが発行ライセンスを使用してエンド ユーザー ライセンスを取得しようとしたときに、発行ライセンスの所有者に通知電子メールが送信されます。 |
| MS.Notify.Culture | string | “en-US” |
ソース: System.Globalization.CultureInfo.CurrentUICulture.Name この値は、通知電子メールのローカライズ言語と、電子メール メッセージで使用する日付/時刻と数値の書式設定の指定に使用します。 発行ライセンスが作成されたコンピューターのユーザー設定、または発行ライセンスの所有者の優先カルチャに基づいて設定してください。 |
| MS.Notify.TZID | string | “Pacific Standard Time” |
ソース: TimeZoneInfo.Local.Id - Windows タイム ゾーンの ID。 この値は、特定のタイム ゾーンとその特性を表す Microsoft Windows OS のタイム ゾーンの識別子です。 |
| MS.Notify.TZO | string | “-480” | UTC 時刻の分の観点から求められる、発行ライセンス所有者のタイム ゾーン オフセットです。 有効な TZID 値が指定されている場合は、それによって指定されるタイム ゾーンのオフセットが使用され、この値は無視されます。 ほとんどの場合、この値は Windows OS のタイム ゾーン ID 値のリストへのアクセス権がない非 Windows ベースの公開プラットフォームで使用されます。 TZID 値が指定されていない場合は、通知メッセージのタイム オフセットの計算にこの値が使用され、タイム ゾーン名の表示に (タイム ゾーン値に関係なく) TZSN が使用されます。 これにより、タイム ゾーンが固定され、夏時間で更新されなくなります (該当する場合)。 例を以下に示します。 TXID を空白、TZ0 を「-420」、TZSN を「Pacific Daylight Time」に設定すると、通知電子メールに表示されるすべての値が「太平洋夏時間」に調整され、夏時間ではなくなった場合でもそのように表示されます。 その一方で、TZID と共に TZSN と TZDN を指定すると、通知電子メール内に指定された時刻の調整と表示は、日付と時刻を夏時間モードと標準モードのどちらで表示するかに基づいて決まります。 |
| MS.Notify.TZSN | string | “Pacific Standard Time” |
ソース: TimeZoneInfo.Local.StandardName - 標準タイム ゾーンの名前。 タイム ゾーンの標準タイム ゾーン名のローカライズされた名前にする必要があります。 |
| MS.Notify.TZDN | string | “Pacific Daylight Time” |
ソース: TimeZoneInfo.Local.DaylightName - 夏時間タイム ゾーンの名前。 タイム ゾーンの夏時間名のローカライズされた名前にする必要があります。 タイム ゾーンが夏時間をサポートしていない場合は、標準名と同じにすることができます。 |