GetObjectDataOnClearChannel method

The GetObjectDataOnClearChannel method transfers a block of object data on a clear channel back to Windows Media Device Manager.

This method is identical to ISCPSecureExchange::ObjectData except that the data returned by this method is not encrypted. Consequently this method is more efficient.

Syntax

HRESULT GetObjectDataOnClearChannel(
   IMDSPDevice *pDevice,
   BYTE        *pData,
   DWORD       *pdwSize
);

Parameters

pDevice

Pointer to the device object.

pData

Pointer to a buffer to receive data.

pdwSize

Pointer to a DWORD containing the transfer size.

Return value

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

Return code	Description
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.
S_FALSE	The method failed. Terminate interaction with the content provider.
E_INVALIDARG	A parameter is an invalid or NULL pointer.
E_FAIL	An unspecified error occurred.

Remarks

To transfer data, Windows Media Device Manager calls the TransferContainerDataOnClearChannel method to obtain the container data. GetObjectDataOnClearChannel is then called to transfer blocks of object data from the content provider to Windows Media Device Manager. If S_OK is returned with pdwSize set to zero, Windows Media Device Manager will request no further data.

This method is identical to ISCPSecureExchange::ObjectData except that the data returned by this method is not encrypted. Consequently this method is more efficient.

Requirements

Requirement	Value
Header	WMSCP.idl
Library	Mssachlp.lib

See also

ISCPSecureExchange::ObjectData

ISCPSecureExchange3 Interface