IWMDRMLicenseManagement::CleanLicenseStore 方法

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

CleanLicenseStore 方法从临时许可证存储中删除不可用的许可证,并整理本地许可证存储以提高性能。

语法

HRESULT CleanLicenseStore(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

参数

dwFlags [in]

指定要使用的许可证存储清理选项的标志。 设置为下表中的常量之一。

返回的常量 描述
WMDRM_CLEAN_LICENSE_STORE_SYNC 清理操作将以同步方式执行。 在操作完成之前,此方法不会返回。
WMDRM_CLEAN_LICENSE_STORE_ASYNC 清理操作将以异步方式执行。 此方法将立即返回。 操作完成后,将发送媒体事件 MELicenseStoreCleaned。

ppunkCancelationCookie [out]

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

返回值

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

返回代码 说明
S_OK
方法成功。
DRM_E_LICENSENOTFOUND
客户端计算机上没有临时许可证存储。

备注

此方法异步执行。 调用后立即返回 ,然后在处理完成后生成 MEWMDRMLicenseStoreCleaned 事件。

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

要求

要求
标头
Wmdrmsdk.h

Wmdrmsdk.lib

另请参阅

IWMDRMLicenseManagement 接口