IWMDRMDevice::GetMeterChallenge method
The GetMeterChallenge method retrieves the metering challenge.
Syntax
HRESULT GetMeterChallenge(
[in] BSTR bstrMeterCert,
[out] BYTE **ppbMeterChallenge,
[out] 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 value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
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
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|