How to: Use built-in rights
Important
Versions of the Microsoft Rights Management Service SDK released prior to March 2020 are deprecated; applications using earlier versions must be updated to use the March 2020 release. For full details, see the deprecation notice.
No further enhancements are planned for the Microsoft Rights Management Service SDK. We strongly recommend adoption of the Microsoft Information Protection SDK for classification, labeling, and protection services.
This topic outlines the built-in rights that the Microsoft Rights Management SDK 4.2 provides and usage restrictions that an app should enforce in honoring those restrictions. The following shows the built-in rights; common rights, editable document rights and email rights follwed by a description and their values by operating system.
Note - For the Linux SDK, see the rights.h source file for details.
Common Rights
All - A collection of all common rights.
- Android: CommonRights.All
- iOS and OS X: MSCommonRights - user owner and view to implement All
- Windows Store and Windows Phone: CommonRights.All
- Linux: CommonRights::All
Owner - The Owner right grants full control over the protected content.
- Android: CommonRights.Owner
- iOS and OS X: MSCommonRights owner
- Windows Store and Windows Phone: CommonRights.Owner
- Linux: CommonRights::Owner
View - The right to view protected content. Typically, when this right is granted, the application enables the user to open and view protected content; however, additional rights are required to modify, extract, forward, or save the content.
- Android: CommonRights.View
- iOS and OS X: MSCommonRights view
- Windows Store and Windows Phone: CommonRights.View
- Linux: CommonRights::View
Editable Document Rights
All - A collection that contains all of the editable document rights.
- Android: EditableDocumentRights.All
- iOS and OS X: MSEditableDocumentRights all
- Windows Store and Windows Phone: EditableDocumentRights.All
- Linux: EditableDocumentRights::All
Comment - The right to make comments on the document.
- Android: EditableDocumentRights.Comment
- iOS and OS X: MSEditableDocumentRights comment
- Windows Store and Windows Phone: EditableDocumentRights.Comment
- Linux: EditableDocumentRights::Comment
Edit - The right to edit protected content and save it in the same protected format. Typically, when this right is granted, the app enables the user to change protected content and then save it to the same file.
- Android: EditableDocumentRights.Edit
- iOS and OS X: MSEditableDocumentRights edit
- Windows Store and Windows Phone: EditableDocumentRights.Edit
- Linux: EditableDocumentRights::Edit
Export - The right to extract content from a protected format and place it in a different AD RMS-protected format. Typically, when this right is granted, the app enables the user to save protected content to other AD RMS-protected formats; for example, if the application implements a Save As functionality.
- Android: EditableDocumentRights.Export
- iOS and OS X: MSEditableDocumentRights exportable
- Windows Store and Windows Phone: EditableDocumentRights.Export
- Linux: EditableDocumentRights::Export
Extract - The right to extract content from a protected format and place it in an unprotected format. Typically, when this right is granted, the app enables the user to copy and paste information from protected content. If the app implements a Save As functionality, the application might also enable the user to save protected content to unprotected formats and other protected formats. This right has the same value as the Extract right for email.
- Android: EditableDocumentRights.Extract
- iOS and OS X: MSEditableDocumentRights extract
- Windows Store and Windows Phone: EditableDocumentRights.Extract
- Linux: EditableDocumentRights::Extract
Print - The right to print protected content. Typically, when this right is granted, the app enables the user to print protected content. This right has the same value as the Print right for email.
- Android: EditableDocumentRights.Print
- iOS and OS X: MSEditableDocumentRights print
- Windows Store and Windows Phone: EditableDocumentRights.Print
- Linux: EditableDocumentRights::Print
Email Rights
All - A collection that contains all of the email rights.
- Android: EmailRights.All
- iOS and OS X: MSEmailRights all
- Windows Store and Windows Phone: EmailRights.All
- Linux: EmailRights::All
Extract - The right to extract content from a protected format and place it in an unprotected format. Typically, when this right is granted, the app enables an email recipient to copy and paste information from a protected message. If the app implements a Save As functionality, the application might also enable the recipient to save protected content to unprotected formats and other protected formats. This right has the same value as the Extract right for editable documents.
- Android: EmailRights.Extract
- iOS and OS X: MSEmailRights extract
- Windows Store and Windows Phone: EmailRights.Extract
- Linux: EmailRights::Extract
Forward - The right to forward a protected message. Typically, when this right is granted, the app enables an email recipient to forward a protected message.
- Android: EmailRights.Forward
- iOS and OS X: MSEmailRights forward
- Windows Store and Windows Phone: EmailRights.Forward
- Linux: EmailRights::Forward
Print - The right to print protected content. Typically, when this right is granted, the app enables an email recipient to print a protected message. This right has the same value as the Print right for editable documents.
- Android: EmailRights.Print
- iOS and OS X: MSEmailRights print
- Windows Store and Windows Phone: EmailRights.Print
- Linux: EmailRights::Print
Reply - Typically, when this right is granted, the app enables an email recipient to reply to a protected message and include a copy of the original message.
- Android: EmailRights.Reply
- iOS and OS X: MSEmailRights reply
- Windows Store and Windows Phone: EmailRights.Reply
- Linux: EmailRights::Reply
ReplyAll - Typically, when this right is granted, the app enables an email recipient to reply to all recipients of a protected message and include a copy of the original message.
- Android: EmailRights.ReplyAll
- iOS and OS X: MSEmailRights replyAll
- Windows Store and Windows Phone: EmailRights.ReplyAll
- Linux: EmailRights::ReplyAll