Skip to content

Latest commit

 

History

History
174 lines (132 loc) · 5.09 KB

nf-mswmdm-iscpsecurequery3-getrightsonclearchannel.md

File metadata and controls

174 lines (132 loc) · 5.09 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:mswmdm.ISCPSecureQuery3.GetRightsOnClearChannel
ISCPSecureQuery3::GetRightsOnClearChannel (mswmdm.h)
The GetRightsOnClearChannel method retrieves rights information for the current piece of content on a clear channel.
GetRightsOnClearChannel
GetRightsOnClearChannel method [windows Media Device Manager]
GetRightsOnClearChannel method [windows Media Device Manager]
ISCPSecureQuery3 interface
ISCPSecureQuery3 interface [windows Media Device Manager]
GetRightsOnClearChannel method
ISCPSecureQuery3.GetRightsOnClearChannel
ISCPSecureQuery3::GetRightsOnClearChannel
ISCPSecureQuery3GetRightsOnClearChannel
mswmdm/ISCPSecureQuery3::GetRightsOnClearChannel
wmdm.iscpsecurequery3_getrightsonclearchannel
wmdm\iscpsecurequery3_getrightsonclearchannel.htm
WMDM
ab64b790-848a-4c7f-9bf9-4a9b40bcc9cb
12/05/2018
GetRightsOnClearChannel, GetRightsOnClearChannel method [windows Media Device Manager], GetRightsOnClearChannel method [windows Media Device Manager],ISCPSecureQuery3 interface, ISCPSecureQuery3 interface [windows Media Device Manager],GetRightsOnClearChannel method, ISCPSecureQuery3.GetRightsOnClearChannel, ISCPSecureQuery3::GetRightsOnClearChannel, ISCPSecureQuery3GetRightsOnClearChannel, mswmdm/ISCPSecureQuery3::GetRightsOnClearChannel, wmdm.iscpsecurequery3_getrightsonclearchannel
mswmdm.h
Windows
Mssachlp.lib
Windows
19H1
ISCPSecureQuery3::GetRightsOnClearChannel
mswmdm/ISCPSecureQuery3::GetRightsOnClearChannel
c++
APIRef
kbSyntax
COM
mssachlp.lib
mssachlp.dll
ISCPSecureQuery3.GetRightsOnClearChannel

ISCPSecureQuery3::GetRightsOnClearChannel

-description

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

-parameters

-param pData [in]

Pointer to data object.

-param dwSize [in]

Number of bytes of data in the pData buffer.

-param pbSPSessionKey [in]

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

-param dwSessionKeyLen [in]

Length of the byte array to which pbSPSessionKey points.

-param 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.

-param pProgressCallback [in]

Pointer to an IWMDMProgress3 interface.

-param 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.

-param pnRightsCount [out]

Number of WMDMRIGHTS structures in the ppRights array.

-returns

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.

-see-also

ISCPSecureQuery3 Interface

ISCPSecureQuery::GetRights

IWMDMStorageGlobals Interface

WMDMRIGHTS