IWMDRMLicenseManagement::RestoreLicenses 方法

RestoreLicenses 方法从通过调用 BackupLicenses 方法创建的许可证备份还原许可证。

语法

HRESULT RestoreLicenses(
  [in]  BSTR     bstrBackupDirectory,
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

参数

bstrBackupDirectory [in]

将从中还原许可证的位置的 UNC 路径。

dwFlags [in]

指定要使用的还原选项的标志。 当前支持的唯一标志是WMDRM_RESTORE_INDIVIDUALIZE,如果需要,它将方法配置为在还原过程中执行个性化。

ppunkCancelationCookie [out]

用于接收指向标识此异步调用的对象 IUnknown 接口的指针的指针。 此接口指针可用于通过调用 IWMDRMEventGenerator::CancelAsyncOperation 方法取消异步调用。

返回值

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

返回代码 说明
S_OK
方法成功。

备注

此方法异步执行。 调用后立即返回,然后在处理完成后生成一系列 MEWMDRMLicenseRestoreProgress 事件,后跟 MEWMDRMLicenseRestoreCompleted 事件。 通过调用 IMFMediaEvent::GetValue 获取的每个 MEWMDRMLicenseRestoreProgress 事件的值是 IUnknown 指针。 可以调用检索到的 IUnknown 接口的 QueryInterface 方法以获取 IWMDRMLicenseBackupRestoreStatus 接口的实例。

有关使用Windows媒体 DRM 客户端扩展 API 的异步方法的详细信息,请参阅使用 Media Foundation 事件模型

备份可以来自本地计算机或另一台计算机。

要求

要求 Value
标头
Wmdrmsdk.h

Wmdrmsdk.lib

另请参阅

IWMDRMLicenseManagement 接口