Windows Media Rights Manager SDK banner art

WMRMRights.BeginDate

The BeginDate property specifies and retrieves the date before which the license is not valid.

Syntax

WMRMRights.BeginDate = String
String = WMRMRights.BeginDate

Parameters

This property takes no parameters.

Return Values

If the property succeeds, it returns a String containing the date. If it fails, it returns a number in the error object.

Return code Description
0xC004290A The specified date is not valid.

Remarks

This property is useful when predelivering licenses for future events. By default, this right is not set and the license is effective immediately. The property fails if the expiration date is in a format that is not valid. Dates in licenses are in Greenwich Mean Time (GMT) and must be formatted as follows:

#yyyymmdd hh:mm:ssZ#

  • Z is required.
  • hh:mm:ss is optional.
  • hh can be present without either mm or ss.
  • hh, mm and ss must be written with two digits each.

Correct examples:

#20050212Z#

#20050212 09Z#

#20050212 09:45Z#

#20050212 09:45:12Z#

Incorrect examples:

#20050212 9Z#

#20050212 09:Z#

#20050212 09:8Z#

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 = False
    RightsObj.AllowPlay = True
    RightsObj.BeginDate = "#20050101Z#"
    RightsObj.ExpirationDate = "#20051231Z#"
    RightsObj.DisableOnClockRollback = 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