Share via


Windows Media Rights Manager SDK banner art

WMRMLicGen.IsClientExcluded

You can use the IsClientExcluded property to determine whether the consumer's player that is requesting a license is based on an excluded DRM component (known by Microsoft to be damaged or corrupted).

Syntax

Boolean = WMRMLicGen.IsClientExcluded

Parameters

This property takes no parameters.

Return Values

This property does not return a value. If it succeeds, it sets S_OK in the error object. If the property fails, it returns a number in the error object.

Return code Description
0x80048017 The application exclusion information has not been set.

Remarks

Use this property when receiving a license request so you can determine whether the requesting application is one that you want to exclude. If it is, you can refuse to issue a license. You might also display information to the consumer (for example, explaining that you will only issue licenses to certain players.

Example Code

' The client (player) posts a challenge to the license issuer. The 
' challenge contains the packaged file's content header, actions requested
' by the client, and information about the client computer. To determine a
' client application's individualization version, perform the following 
' steps. 

' Declare variables and objects.
    Dim sHeader, lResult, sLicRequest, indiVersion 
    Dim HeaderObj, ChallengeObj, LicGenObj 
    Dim bAppRevoked

' Create objects.
    Set HeaderObj = Server.CreateObject("Wmrmobjs.WMRMHeader")
    Set ChallengeObj = Server.CreateObject("Wmrmobjs.WMRMChallenge")
    Set LicGenObj = Server.CreateObject("Wmrmobjs.WMRMLicGen")

' Retrieve the license request from the client computer.
    sLicRequest = request.Form("challenge")

' Set the license request into the WMRMChallenge object.
    ChallengeObj.Challenge = sLicRequest

' Retrieve the header from the challenge.
    sHeader = ChallengeObj.Header

' Set the header into the WMRMHeader object.
    HeaderObj.Header = sHeader

' Verify the header with the public key created by the content
' packager.
    lResult = HeaderObj.Verify(sPubKey)
    if (lResult = 0) then
        ' The header is corrupt.
    end if

' Find out if the application uses an excluded DRM component.
   bAppRevoked = LicGenObj.IsClientExcluded
   if (bAppRevoked = True) then
       ' The player application is revoked.
   end if

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