IXpsSignature::Verify 方法 (xpsdigitalsignature.h)

根据指定的 X.509 证书验证签名。

语法

HRESULT Verify(
  [in]          const CERT_CONTEXT   *x509Certificate,
  [out, retval] XPS_SIGNATURE_STATUS *sigStatus
);

参数

[in] x509Certificate

包含用于验证的 X.509 证书 的CERT_CONTEXT 结构。

如果签名不完整或不合规,则此证书仅用于验证 XPS 包中的签名数据是否完好无损。 证书不会用于执行任何其他检查。 在使用证书之前,应用程序应验证信任链和任何其他要求。

[out, retval] sigStatus

描述验证结果 的XPS_SIGNATURE_STATUS 值。

返回值

该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的返回值,请参阅 XPS 数字签名 API 错误XPS 文档错误

返回代码 说明
S_OK
方法成功。
E_POINTER
x509CertificatesigStatusNULL
E_UNEXPECTED
接口未连接到签名管理器。

注解

此方法按 XML 纸张规范第 10.2.1.2 节中指定的顺序检测签名状态。 检测顺序如下:不合规、不完整、损坏、可疑,最后有效。 这意味着,例如,如果发现签名不合规,则不会计算签名也损坏的摘要。

有关此方法可以检测到的不同类型的签名状态的详细信息,请参阅 XPS_SIGNATURE_STATUS

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 xpsdigitalsignature.h

另请参阅

CERT_CONTEXT

IOpcDigitalSignature

IXpsSignature

IXpsSignatureManager

XML 纸张规范

XPS 数字签名 API 错误

XPS 文档错误

XPS_SIGNATURE_STATUS