IWMDRMDeviceApp::GenerateMeterChallenge 方法
GenerateMeterChallenge 方法从设备获取计量数据。
HRESULT GenerateMeterChallenge(
[in] IWMDMDevice *pDevice,
[in] BSTR bstrMeterCert,
[out] BSTR *pbstrMeterURL,
[out] BSTR *pbstrMeterData
);
-
pDevice [in]
-
指向 IWMDMDevice 接口的指针。 如果应用程序以 NULL 传递,则使用计算机上存储的计量信息,而不是来自已连接设备的计量信息。
-
bstrMeterCert [in]
-
应用程序的计量证书,作为 BSTR。 这是从 Microsoft 收到的已签名证书。
-
pbstrMeterURL [out]
-
应在其中发送计量数据的 URL。 这由 Windows Media 设备管理器分配,并且必须由调用方使用 SysFreeString 释放。
-
pbstrMeterData [out]
-
要发送到计量服务的计量数据。 这由 Windows Media 设备管理器分配,并且必须由调用方使用 SysFreeString 释放。
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
一个或多个参数无效。 |
|
XML 格式不正确。 |
|
XML 格式不正确。 |
|
XML 格式不正确。 |
|
找不到所需的 XML 标记。 |
|
任意数量的设备错误。 |
|
任意数量的内部 DRM 客户端错误。 |
|
指定的设备不是与 Windows Media DRM 兼容的设备。 |
在调用此方法之前,应用程序应调用 IWMDRMDeviceApp::QueryDeviceStatus 或 IWMDRMDeviceApp2::QueryDeviceStatus2 ,以验证设备的所有 DRM 组件是否为最新。 只能在支持适用于可移植设备的 Windows Media DRM 10 的设备上调用此方法。
检索到的数据 pbstrMeterData 应发送到 pbstrMeterURL 指定的 URL。 请务必对检索到的数据进行 URL 编码,以免在传输过程中对其进行修改。
有关详细信息 ,请参阅处理应用程序中的受保护内容 。
以下 C++ 代码示例创建 WMDRMDeviceApp 对象,验证设备是 Windows Media DRM 10 设备,其时钟是否准确,然后请求计量数据。
HRESULT hr = S_OK;
// Create the WMDRMDeviceApp object.
CComPtr<IWMDRMDeviceApp> pDRM;
hr = pDRM.CoCreateInstance(CLSID_WMDRMDeviceApp, 0, CLSCTX_ALL);
// Find out first if the device is a WMDRM 10 device, and if it requires
// any clock updates.
DWORD status = 0;
hr = pDRM->QueryDeviceStatus(pDevice, &status);
if (!(WMDRM_DEVICE_ISWMDRM & status)) // Device is not WMDRM 10. Nothing can be updated,
return E_FAIL; // and metering cannot be performed.
else if (status & WMDRM_DEVICE_REVOKED) // Device is revoked.
return E_FAIL;
else if (status & WMDRM_DEVICE_NEEDCLOCK ||
status & WMDRM_CLIENT_NEEDINDIV ||
status & WMDRM_DEVICE_REFRESHCLOCK)
{
// Need to update device clock.
// Using custom function, which is synchronous.
hr = myAcquireDeviceData(pDRM, pDevice, this, status, &result);
if (hr != S_OK || result != 0) // Couldn't perform the updates.
return E_FAIL;
}
// Any updates have been performed. Now get the metering information from the device.
CComBSTR meterCert(METERCERT);
CComBSTR URL;
CComBSTR rawdata;
CComBSTR data;
hr = pDRM->GenerateMeterChallenge(pDevice, meterCert, &URL, &rawdata);
if (hr == S_OK)
..... Send to URL...
要求 | Value |
---|---|
标头 |
|
库 |
|