WMRMChallenge.Action
.gif)
| Previous | Next |
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.
| Return code | Description |
| 0x80004005 | An unspecified error occurred. |
| 0x80070057 | The specified parameter is not valid. |
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
| Previous | Next |