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。 可能的值包括（但并不限于）下表中的项。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
备注
此方法异步执行。 它在被调用后立即返回，然后在处理完成后生成一系列 MEWMDRMLicenseRestoreProgress 事件，后跟 MEWMDRMLicenseRestoreCompleted 事件。 通过调用 IMFMediaEvent：：GetValue 获取的每个 MEWMDRMLicenseRestoreProgress 事件的值都是一个 IUnknown 指针。 可以调用检索到的 IUnknown 接口的 QueryInterface 方法来获取 IWMDRMLicenseBackupRestoreStatus 接口的实例。
有关使用 Windows Media DRM 客户端扩展 API 的异步方法的详细信息，请参阅 使用媒体基础事件模型。
备份可以来自本地计算机，也可以来自其他计算机。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|