Share via

IWMDRMDevice::GetMeterChallenge

  • Article
banner art

The GetMeterChallenge method retrieves the metering challenge.

Syntax

HRESULT GetMeterChallenge(BSTRbstrMeterCert,BYTE**ppbMeterChallenge,DWORD*pcbMeterChallenge);

Parameters

bstrMeterCert

[in]  Metering certificate that the content owner sends to the host computer for collecting the associated metering data on the device

ppbMeterChallenge

[out]  Retrieved metering challenge result.

pcbMeterChallenge

[out]  The size of the metering challenge, in bytes.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.

Remarks

Metering data is collected and stored in the DRM data store on the device for content with metering enabled. Actions such as play will be recorded. When this function is called, the device collects the metering data in the DRM data store in the form of an XML document and sends it to the hostcomputer. If there is too much data, it is sent in phases.

When the host computer receives the metering data, it sends the data over the Internet to the URL specified in the metering certificate.

Requirements

Header: Defined in WMDDRMSP.idl.

Library: mssachlp.lib

See Also