WMRMChallenge.Action

WMRMChallenge.Action

The Action property retrieves a specific action from the list of actions requested in a challenge.

Syntax

  Bstr = WMRMChallenge.Action(dwIndex)

Parameters

dwIndex

[in] DWORD containing the index of the requested action. The index is zero-based.

Return Values

If the property succeeds, it returns a String containing the requested action, such as Play, Copy, BurnToCD, and so forth.

If the property fails, it returns a number in the error object.

Remarks

This property is read-only. Actions are client requests for rights to use the encrypted content. For instance, if the challenge contains a request to play the encrypted content, <ACTION>Play</ACTION>, the Action property returns a String containing "Play". The index is zero-based. Therefore, to find a specific action, you must call WMRMChallenge.ActionCount and loop through the collection of actions from zero (0) to Challenge.ActionCount – 1.

Action properties are not present in the challenge that is generated when predelivering a license.

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

• WMRMChallenge Object
• WMRMChallenge.ActionCount

© 2007 Microsoft Corporation. All rights reserved.