WMRMRights.ExcludeApplication
The ExcludeApplication method specifies the application ID of a player that you want to prevent from accessing your protected files.
Syntax
WMRMRights.ExcludeApplication(dwAppID)
Parameters
dwAppID
[in] DWORD containing the application ID of the player to exclude.
Return Values
This method does not return a value.
Remarks
Only players based on the Windows Media Format 7.1 or later SDK can interpret this right. You can use the WMRMChallenge.CheckClientCapability method to find out whether a player is based on Windows Media Format 7.1 SDK or a later version, and then specify the rights accordingly.
You can exclude any player from using your packaged files; the player does not have to be revoked in order for you to exclude it. You can find the application ID of a player when you receive a license request from it by using the SUBJECTID2 attribute with the WMRMChallenge.ClientAttribute property.
Call this method once for every player to exclude.
You can also determine whether a player has been excluded before you issue a license by using the WMRMLicGen.IsClientExcluded property. However, this WMRMRights.ExcludeApplication method is useful when enforcing application exclusion after a license has been issued. For example, a consumer might try to use a different player than the one used to acquire the license, or you might choose to predeliver licenses.
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.DisableOnClockRollback = True
' Exclude two applications.
RightsObj.ExcludeApplication(123)
RightsObj.ExcludeApplication(456)
' 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