IWMDRMSecurity：:P erformSecurityUpdate 方法

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

PerformSecurityUpdate 方法将安全更新启动到本地计算机上的 DRM 子系统。

语法

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

参数

dwFlags [in]

更新选项表示为以下标志之一。

标志	描述
WMDRM_SECURITY_PERFORM_INDIV	仅当客户端版本过期时，才使 DRM 组件个性化。
WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH	导致更新客户端计算机上的吊销列表。
WMDRM_SECURITY_PERFORM_FORCE_INDIV	使 DRM 组件个性化，即使客户端的版本是最新的。

ppunkCancelationCookie [out]

一个变量的地址，该变量接收指向可用于取消此操作的对象的指针。

返回值

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

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

备注

此方法异步执行。 调用后，它会立即返回 ，然后根据 dwFlags 参数中设置的标志生成事件。

对于设置为 WMDRM_SECURITY_PERFORM_INDIV 或 WMDRM_SECURITY_PERFORM_FORCE_INDIV) 的个性化 (标志，处理完成后会生成一系列 MEWMDRMIndividualizationProgress 事件，后跟 MEWMDRMIndividualizationCompleted 事件。 通过调用 IMFMediaEvent：：GetValue 获取的每个 MEWMDRMIndividualizationProgress 事件的值都是 IUnknown 指针。 可以调用检索到的 IUnknown 接口的 QueryInterface 方法来获取 IWMDRMIndividualizationStatus 接口的实例。

若要刷新吊销列表 (标志设置为 WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH) ，将在处理完成后生成 MEWMDRMREvocationDownloadCompleted 事件。

注意

当 PerformSecurityUpdate 完成个性化时，唯一反映新个性化状态的现有对象是继承自 IWMDRMSecurity 的对象。 所有其他现有对象都不会更新。 必须释放并重新创建任何其他对象，以便它们反映新的个性化状态。

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

要求

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

另请参阅

自动组件吊销和续订

DRM 个性化示例

IWMDRMSecurity 接口

执行 DRM 个性化