IWMDRMSecurity::GetMachineCertificate 方法

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

GetMachineCertificate 方法检索客户端计算机上 DRM 子系统的计算机证书。

语法

HRESULT GetMachineCertificate(
  [in]      DWORD dwCertificateType,
  [out]     BYTE  rgbVersion[4],
  [out]     BYTE  **ppbCertificate,
  [in, out] DWORD *pcbCertificate
);

参数

dwCertificateType [in]

要检索的证书的类型。 将 设置为下表中的值之一。

说明
WMDRM_CERTIFICATE_TYPE_V1 将采用旧组件使用的格式检索证书。
WMDRM_CERTIFICATE_TYPE_V2 将采用 Windows Vista 组件使用的格式检索证书。

rgbVersion[4] [out]

四个字节的数组,指定客户端计算机上的 DRM 子系统的版本。

ppbCertificate [out]

接收指向证书数据的指针的变量的地址。 设置为 NULL 可让 方法提供将证书保存在 证书所需的缓冲区大小。

2016 年 [in, out]

证书的大小(以字节为单位)。 如果 ppbCertificateNULL,此值将设置为证书的大小。 如果 ppbCertificate 不为 NULL,则必须将此值设置为缓冲区的大小。

返回值

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

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

要求

要求
标头
Wmdrmsdk.h

Wmdrmsdk.lib

另请参阅

IWMDRMSecurity 接口