4.7 Remove IRM Protection by Using the ItemOperations Command

To remove IRM protection from a rights-managed e-mail message, the user first uses the Sync command to sync the e-mail message to the client. The client then uses the ItemOperations command to remove rights management protection. This section includes both successful and unsuccessful ItemOperations responses.

ItemOperations Request

The ItemOperations command request includes the RemoveRightsManagementProtection element to remove IRM protection from the e-mail message.

 <?xml version="1.0" encoding="utf-8"?>
 <ItemOperations xmlns:airsyncbase="AirSync:" xmlns:airsyncbase="AirSyncBase:" xmlns="ItemOperations:" xmlns:rm="RightsManagement:">
   <Fetch>
     <Store>Mailbox</Store>
     <airsyncbase:CollectionId>5</airsyncbase:CollectionId>
     <airsyncbase:ServerId>5:1</airsyncbase:ServerId>
     <Options>
       <airsyncbase:BodyPreference>
         <airsyncbase:Type>1</airsyncbase:Type>
         <airsyncbase:TruncationSize>1024</airsyncbase:TruncationSize>
       </airsyncbase:BodyPreference>
       <rm:RightsManagementSupport>1</rm:RightsManagementSupport>
     </Options>
     <rm:RemoveRightsManagementProtection/>
   </Fetch>
 </ItemOperations>

Successful ItemOperations Response

In this scenario, the ItemOperations command was successful because the ExportAllowed value was set to TRUE for the rights policy template applied to the e-mail message. The e-mail message included in the response has no IRM protection and includes the previously protected content in the body of the message.

 <?xml version="1.0" encoding="utf-8"?>
 <ItemOperations xmlns:airsyncbase="AirSync:" xmlns:email="Email:" xmlns:airsyncbase="AirSyncBase:" xmlns:email2="Email2:" xmlns="ItemOperations:">
   <Status>1</Status>
   <Response>
     <Fetch>
       <Status>1</Status>
       <airsyncbase:CollectionId>5</airsyncbase:CollectionId>
       <airsyncbase:ServerId>5:1</airsyncbase:ServerId>
       <airsyncbase:Class>Email</airsyncbase:Class>
       <Properties>
         <email:To>"T0SyncUser3" &lt;T0SyncUser3@contoso.com&gt;</email:To>
         <email:From>"T0SyncUser1" &lt;T0SyncUser1@contoso.com&gt;</email:From>
         <email:Subject>Confidential</email:Subject>
         <email:DateReceived>2010-06-30T23:47:06.961Z</email:DateReceived>
         <email:DisplayTo>T0SyncUser3</email:DisplayTo>
         <email:ThreadTopic>Confidential</email:ThreadTopic>
         <email:Importance>1</email:Importance>
         <email:Read>0</email:Read>
         <airsyncbase:Body>
           <airsyncbase:Type>1</airsyncbase:Type>
           <airsyncbase:EstimatedDataSize>64</airsyncbase:EstimatedDataSize>
           <airsyncbase:Data>This is a test message that we want to use.</airsyncbase:Data>
         </airsyncbase:Body>
         <email:MessageClass>IPM.Note</email:MessageClass>
         <email:InternetCPID>28591</email:InternetCPID>
         <email:Flag />
         <email:ContentClass>urn:content-classes:message</email:ContentClass>
         <airsyncbase:NativeBodyType>2</airsyncbase:NativeBodyType>
         <email2:ConversationId>…</email2:ConversationId>
         <email2:ConversationIndex>…</email2:ConversationIndex>
         <email2:IsDraft>0</email2:IsDraft>
       </Properties>
     </Fetch>
   </Response>
 </ItemOperations>

Unsuccessful ItemOperations Response

In this scenario, the ItemOperations command to remove rights management protection was not successful because the ExportAllowed value was set to FALSE for the rights policy template applied to the e-mail message. The ItemOperations command response includes the protected content in the body of the message, but the message is still a rights-managed e-mail message and is using the ViewOnly template to restrict editing, forwarding, replying, replying all, exporting, or extracting the content.

 <?xml version="1.0" encoding="utf-8"?>
 <ItemOperations xmlns:airsync="AirSync:" xmlns:email="Email:" xmlns:airsyncbase="AirSyncBase:" xmlns:rm="RightsManagement:" xmlns="ItemOperations:">
   <Status>1</Status>
   <Response>
     <Fetch>
       <Status>1</Status>
       <airsync:CollectionId>5</airsync:CollectionId>
       <airsync:ServerId>5:1</airsync:ServerId>
       <airsync:Class>Email</airsync:Class>
       <Properties>
         <email:To>"T0SyncUser3" &lt;T0SyncUser3@contoso.com&gt;</email:To>
         <email:From>"T0SyncUser1" &lt;T0SyncUser1@contoso.com&gt;</email:From>
         <email:Subject>Confidential</email:Subject>
         <email:DateReceived>2010-06-30T23:47:06.961Z</email:DateReceived>
         <email:DisplayTo>T0SyncUser3</email:DisplayTo>
         <email:ThreadTopic>Confidential</email:ThreadTopic>
         <email:Importance>1</email:Importance>
         <email:Read>0</email:Read>
         <airsyncbase:Body>
           <airsyncbase:Type>1</airsyncbase:Type>
           <airsyncbase:EstimatedDataSize>64</airsyncbase:EstimatedDataSize>
           <airsyncbase:Data>This is a test message that we want to use.</airsyncbase:Data>
         </airsyncbase:Body>
         <email:MessageClass>IPM.Note</email:MessageClass>
         <email:InternetCPID>28591</email:InternetCPID>
         <email:Flag />
         <email:ContentClass>urn:content-classes:message</email:ContentClass>
         <airsyncbase:NativeBodyType>2</airsyncbase:NativeBodyType>
         <email2:ConversationId>…</email2:ConversationId>
         <email2:ConversationIndex>…</email2:ConversationIndex>
         <rm:RightsManagementLicense>
           <rm:Owner>0</rm:Owner>
           <rm:ContentOwner>T0SyncUser1v14.1@contoso.com</rm:ContentOwner>
           <rm:ReplyAllAllowed>0</rm:ReplyAllAllowed>
           <rm:EditAllowed>0</rm:EditAllowed>
           <rm:ReplyAllowed>0</rm:ReplyAllowed>
           <rm:ForwardAllowed>0</rm:ForwardAllowed>
           <rm:ExportAllowed>0</rm:ExportAllowed>
           <rm:ModifyRecipientsAllowed>0</rm:ModifyRecipientsAllowed>
           <rm:TemplateID>e9225d21-a80e-4642-81eb-d5e9afe3f33a</rm:TemplateID>
           <rm:ExtractAllowed>0</rm:ExtractAllowed>
           <rm:TemplateDescription>Description for template 'ViewOnly'</rm:TemplateDescription>
           <rm:ContentExpiryDate>9999-12-30T23:59:59.999Z</rm:ContentExpiryDate>
           <rm:TemplateName>ViewOnly</rm:TemplateName>
           <rm:PrintAllowed>0</rm:PrintAllowed>
           <rm:ProgrammaticAccessAllowed>0</rm:ProgrammaticAccessAllowed>
         </rm:RightsManagementLicense>
         <email2:IsDraft>0</email2:IsDraft>
       </Properties>
     </Fetch>
   </Response>
 </ItemOperations>
Show: