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.

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

See also

IWMDRMDevice Interface