IWMDRMDeviceApp::SynchronizeLicenses 方法

SynchronizeLicenses 方法在设备上即将过期时更新许可证。

语法

HRESULT SynchronizeLicenses(
  [in] IWMDMDevice    *pDevice,
  [in] IWMDMProgress3 *pProgressCallback,
  [in] DWORD          cMinCountThreshold,
  [in] DWORD          cMinHoursThreshold
);

parameters

pDevice [in]

指向 IWMDMDevice 对象的指针。

pProgressCallback [in]

进度回调,接收可能需要执行的任何步骤的进度。此步骤由调用的 IWMDMProgress3 方法的 EventId 参数标识。

cMinCountThreshold [in]

可选设备许可证的最小剩余播放计数。

cMinHoursThreshold [in]

可选设备许可证的最短剩余小时数。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
DRM_E_INVALIDARG
一个或多个参数无效。
DRM_E_INVALIDXMLTAG
XML 格式不正确。
DRM_E_NOTIMPL
此功能当前未实现。 (SyncLicenses, pDevice =NULL)
DRM_E_NOXMLCLOSETAG
许可证 XML 格式不正确。
DRM_E_NOXMLOPENTAG
许可证 XML 格式不正确。
DRM_E_OUTOFMEMORY
内存不足。
DRM_E_XMLNOTFOUND
未能在许可证中找到所需的 XML 标记。
NS_E_DEVICE_NOT_WMDRM_DEVICE
指定的设备不是与 Windows Media DRM 兼容的设备。
NS_E_DRM_NEEDS_INDIVIDUALIZATION
DRM 需要一个个性化黑盒来执行此功能。 换句话说,Windows Media Format SDK 需要安全升级。

备注

只能在支持适用于便携式设备的 Windows Media DRM 10 的设备上进行此调用。 必须至少指定一个阈值参数。

要求

要求
标头
WMDRMDeviceApp.h (还需要 Wmdrmdeviceapp_i.c,从 WMDRMDeviceApp.idl)

Mssachlp.lib

请参阅

处理应用程序中受保护的内容

IWMDMProgress3 接口

IWMDRMDeviceApp 接口