ISCPSecureExchange3::GetObjectDataOnClearChannel (deprecated)

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 GetObjectDataOnClearChannel method transfers a block of object data on a clear channel back to Windows Media Device Manager.

Syntax

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

Parameters

pDevice

[in]  Pointer to the device object.

pData

[out]  Pointer to a buffer to receive data.

pdwSize

[in, out]  Pointer to a DWORD containing the transfer size.

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_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

Header: Defined in WMSCP.idl.

Library: mssachlp.lib

See Also