IWMDRMLicenseManagement：：RestoreLicenses 方法

[与此页面关联的功能 Windows Media Format 11 SDK 是一项旧功能。 它已被源读取器和接收器编写器取代。 源读取器和接收器编写器已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用源读取器和接收器编写器，而不是 Windows Media 格式 11 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

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 Media DRM 客户端扩展 API 的异步方法的详细信息，请参阅 使用媒体基础事件模型。

备份可以来自本地计算机，也可以来自其他计算机。

要求

要求	值
标头	Wmdrmsdk.h
库	Wmdrmsdk.lib

另请参阅

IWMDRMLicenseManagement 接口