IWMDRMSecurity::GetContentEnablersFromHashes 方法

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

GetContentEnablersFromHashes 方法检索支持基于哈希证书续订组件的内容启用程序接口。

语法

HRESULT GetContentEnablersFromHashes(
  [in]      BSTR              *rgpbCertHashes,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

参数

rgpbCertHashes [in]

要获取其内容启用程序的证书哈希数组。

cCerts [in]

要为其检索内容启用器的证书数。 这是 rgpbCertHashes 数组中的元素数。

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 接口