IWMDRMLicenseManagement：：BackupLicenses 方法

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

BackupLicenses 方法在本地许可证存储中创建许可证的备份。

语法

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

参数

bstrBackupDirectory [in]

许可证将备份到的位置的 UNC 路径。

dwFlags [in]

指定要使用的备份选项的标志。 当前支持的唯一标志是 WMDRM_BACKUP_OVERWRITE，它将 方法配置为覆盖目录中的任何现有备份文件。

ppunkCancelationCookie [out]

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

返回值

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

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

备注

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

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

并非所有许可证都允许备份。 此方法仅备份允许它的许可证。

要求

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

另请参阅

IWMDRMLicenseManagement 接口