Windows Media Rights Manager SDK banner art

WMRMRights.DeleteOnClockRollback

The DeleteOnClockRollback property specifies and retrieves a Boolean value that indicates whether a license must be deleted if the clock is set to an earlier time.

Syntax

WMRMRights.DeleteOnClockRollback = Boolean
Boolean = WMRMRights.DeleteOnClockRollback

Parameters

This property takes no parameters.

Return Values

If the property succeeds, it returns a Boolean value indicating whether the license should be deleted. If it fails, it returns E_FAIL, 0x80004005.

Remarks

The DeleteOnClockRollback property is mutually exclusive with the WMRMRights.DisableOnClockRollback property. If you set this property after setting DisableOnClockRollback, the rights are set to be deleted instead of disabled when the clock is set to an earlier time. By default, this property is set to 0 and no action is taken when the clock is set to an earlier time.

This property works only if you have set an expiration date first.

Example Code

' Before you can issue a license, you must specify the consumer's
' rights and set them in the WMRMLicGen object.

' Declare objects.
    Dim sRights
    Dim RightsObj
    Dim LicGenObj

' Create objects.
    Set RightsObj = Server.CreateObject("Wmrmobjs.WMRMRights")
    Set LicGenObj = Server.CreateObject("Wmrmobjs.WMRMLicGen")

' Reset the WMRMRights object.
    RightsObj.Reset()

' Specify the rights that will be granted to the consumer.
    RightsObj.AllowBackupRestore = True
    RightsObj.AllowPlay = True
    RightsObj.BeginDate = "#20050101Z#"
    RightsObj.ExpirationDate = "#20051231Z#"
    RightsObj.DeleteOnClockRollback = True

' Retrieve the string containing the rights.
    sRights = RightsObj.GetAllRights()

' Set the rights in the license generator.
    LicGenObj.Rights = sRights

' Continue the license issuing process.

Requirements

Version: Windows Media Rights Manager 7 SDK or later

Reference: wmrmobjs 1.0 Type Library

Library: wmrmobjs.dll

Platform: Windows Server 2003

See Also