IWMDRMDevice::GetMeterChallenge
The GetMeterChallenge method retrieves the metering challenge.
Syntax
HRESULT GetMeterChallenge(
BSTR bstrMeterCert,
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