Share via

ISCPSecureQuery3::GetRightsOnClearChannel (deprecated)

  • Article
banner art

This is preliminary documentation and subject to change.

This topic documents a feature of the Windows Media Device Manager SDK. We recommend that you migrate your application to use the Windows Portable Devices API. For more information, see the Windows Portable Devices SDK.

The GetRightsOnClearChannel method retrieves rights information for the current piece of content on a clear channel.

Syntax

HRESULT GetRightsOnClearChannel(
  BYTE*  pData,
  DWORD  dwSize,
  BYTE*  pbSPSessionKey,
  DWORD  dwSessionKeyLen,
  IMDSPStorageGlobals*  pStgGlobals,
  IWMDMProgress3*  pProgressCallback,
  PWMDMRIGHTS*  ppRights,
  UINT*  pnRightsCount
);

Parameters

pData

[in]  Pointer to data object.

dwSize

[in]  Number of bytes of data in the pData buffer.

pbSPSessionKey

[in]  Pointer to an array of bytes containing the session key for securing communication with the service provider to which pStgGlobals points.

dwSessionKeyLen

[in]  Length of the byte array to which pbSPSessionKey points.

pStgGlobals

[in]  Pointer to an IWMDMStorageGlobals interface on the root storage of the media or device to or from which the file is being transferred.

pProgressCallback

[in]  Pointer to an IWMDMProgress3 interface.

ppRights

[out]  Pointer to an array of WMDMRIGHTS structures containing the rights information for this object. The array is allocated by this method and must be freed using CoTaskMemFree.

pnRightsCount

[out]  Number of WMDMRIGHTS structures in the ppRights array.

Return Values

If the method succeeds, it returns S_OK. If the method fails, it returns an HRESULT error code.

Return code Description
WMDM_E_CALL_OUT_OF_SEQUENCE This method was called out of sequence. ISCPSecureQuery::GetDataDemands and then ISCPSecureQuery::ExamineData must be called, in that order.
WMDM_E_MAC_CHECK_FAILED The message authentication code is not valid.
WMDM_E_NORIGHTS The caller does not have the rights required to perform the requested operation.
E_INVALIDARG A parameter is invalid or is a NULL pointer.
E_FAIL An unspecified error occurred.

Remarks

This method is identical to ISCPSecureQuery::GetRights except that the parameters passed to this method are not encrypted. Consequently this method is more efficient.

Requirements

Header: Defined in WMSCP.idl.

Library: mssachlp.lib

See Also