IWMDRMSecurity::GetContentEnablersForRevocations 方法

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

GetContentEnablersForRevocations 方法检索内容启用程序接口,这些接口支持基于吊销的证书续订组件。

语法

HRESULT GetContentEnablersForRevocations(
  [in]      BYTE              **rgpbCerts,
  [in]      DWORD             *rgpdwCertSizes,
  [in]      GUID              **rgpguidCerts,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

参数

rgpbCerts [in]

要为其检索内容启用器的证书数组。 数组中的元素数必须由 cCerts 指定。

rgpdwCertSizes [in]

包含 rgpbCerts 数组中证书大小的数组。 数组中的元素数必须由 cCerts 指定。

rgpguidCerts [in]

包含 rgpbCerts 数组中的证书类型的数组。 数组中的元素数必须由 cCerts 指定。 对于数组的每个元素,请使用以下值之一。

GUID 常量 说明
WMDRM_REVOCATIONTYPE_APP 指定应用程序证书。
WMDRM_REVOCATIONTYPE_DEVICE 指定设备证书。
WMDRM_REVOCATIONTYPE_CARDEA 为网络设备证书指定 Windows Media DRM。

cCerts [in]

要为其检索内容启用器的证书数。 这是 rgpbCerts 数组、 rgpdwCertSizes 数组和 rgpguidCerts 数组中的元素数。

hResultHint [in]

返回从操作收到的值,该操作因证书吊销而失败。 如果未调用 以响应失败的方法调用,请将 设置为 S_OK。

prgContentEnablers [out]

接收新创建的 IMFContentEnabler 接口的地址的数组。 设置为 NULL 可获取 pcContentEnablers 参数中的内容启用程序数。

pcContentEnablers [in, out]

prgContentEnablers 数组中的元素数。 如果 prgContentEnablersNULL,则此值设置为输出时所需的内容启用程序数。

返回值

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

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

备注

如果使用 IMFContentEnabler 接口续订吊销的组件,则必须向用户阐明该过程。 必须做出此说明,因为更新过程会将信息从客户端计算机发送到 Microsoft 网站。

调用 IMFContentEnabler::AutomaticEnable 时,内容启用程序将使用 Microsoft 网站上的更新服务的地址启动默认浏览器。 标识已吊销组件的唯一标识符将发送到更新服务。 然后,该服务会将浏览器重定向到一个网页,用户可以从该网页下载并安装已撤销组件的新版本。

要求

要求
标头
Wmdrmsdk.h

Wmdrmsdk.lib

另请参阅

自动组件吊销和续订

IWMDRMSecurity 接口