setTimestampRequest

Sets the last backup date and last retention date on a mailbox. It can be called only when authenticated by using a trusted application.

Request

<setTimestampRequest>
   <backup type="dateTime"/>
   <retention type="dateTime"/>
   <retentionModified type="boolean"/>
</setTimestampRequest>

Response

<setTimestampResponse>
   <status type="types:Status"/>
   <retentionModified type="dateTime"/>
</setTimestampResponse>

Elements

backup

Specifies the last backup date on a mailbox.

retention

Specifies the last retention date on a mailbox.

code

Returns the error number related to the event. 0 indicates that the request was successful.

status

Returns the success or failure of the method.

retentionModified

Specifies the date and time that a significant or meaningful part of the item was modified.

RetentionModified is a little different than the retention timestamp. Suppose an item has a retention timestamp. If a user modifies the item by adding a personal attachment or some other significant change, retention software will skip the item because it has already been retained. RetentionModified is now used to catch an item after the first retention and a significant change has occured to the item.

Example

<setTimestampRequest> 
   <backup>20120920T103000Z</backup>
   <retention>20120920T103000Z</retention> 
</setTimestampRequest>

<setTimestampResponse> 
   <status> 
      <code>0</code> 
   </status> 
</setTimestampResponse>