WMRMRights.ExcludeApplication

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

  ' Exclude two applications. 
    RightsObj.ExcludeApplication(123)
    RightsObj.ExcludeApplication(456)

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

• Excluding Player Applications
• Programming Windows Media Rights Manager in C++
• Setting Rights
• WMRMRights Object

© 2007 Microsoft Corporation. All rights reserved.