4.1 Retrieve Rights Policy Templates by Using the Settings Command

To retrieve the rights policy templates available to the user, the client sends the Settings command to the server. The request message includes the settings:RightsManagementInformation and settings:Get elements, which instruct the server to include the rights policy template in the response. In this scenario, the successful response includes two rights policy templates, each specified in its own RightsManagementTemplate element. The unsuccessful response includes settings:Status value 168, which indicates that IRM protection is disabled on the server. Other error values are possible and are specified in section 3.2.4.1.

Request

 <?xml version="1.0" encoding="utf-8"?>
 <Settings xmlns="Settings:">
   <RightsManagementInformation>
     <Get/>
   </RightsManagementInformation>
 </Settings>

Successful Response

 <?xml version="1.0" encoding="utf-8"?>
 <Settings xmlns:rm="RightsManagement:" xmlns="Settings:">
   <Status>1</Status>
   <RightsManagementInformation>
     <Status>1</Status>
     <Get>
       <rm:RightsManagementTemplates>
         <rm:RightsManagementTemplate>
           <rm:TemplateID>cf5cf348-a8d7-40d5-91ef-a600b88a395d</rm:TemplateID>
           <rm:TemplateName>Do Not Forward</rm:TemplateName>
           <rm:TemplateDescription>Recipients can read this message, but they can't forward, print, or copy content. The conversation owner has full permission to their message and all replies.</rm:TemplateDescription>
         </rm:RightsManagementTemplate>
         <rm:RightsManagementTemplate>
           <rm:TemplateID>abfafb18-80a0-4763-ac37-48deb93e51e4</rm:TemplateID>
           <rm:TemplateName>DoNotReplyAll</rm:TemplateName>
           <rm:TemplateDescription>Description for template 'DoNotReplyAll'</rm:TemplateDescription>
         </rm:RightsManagementTemplate>
       </rm:RightsManagementTemplates>
     </Get>
   </RightsManagementInformation>
 </Settings>

Unsuccessful Response

 <?xml version="1.0" encoding="utf-8"?>
 <Settings xmlns:rm="RightsManagement:" xmlns="Settings:">
   <Status>1</Status>
   <RightsManagementInformation>
     <Status>168</Status>
     <Get>
       <rm:RightsManagementTemplates />
     </Get>
   </RightsManagementInformation>
 </Settings>
Show: