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 文档错误。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
x509Certificate 或 sigStatus 为 NULL。 |
|
接口未连接到签名管理器。 |
注解
此方法按 XML 纸张规范第 10.2.1.2 节中指定的顺序检测签名状态。 检测顺序如下:不合规、不完整、损坏、可疑,最后有效。 这意味着,例如,如果发现签名不合规,则不会计算签名也损坏的摘要。
有关此方法可以检测到的不同类型的签名状态的详细信息,请参阅 XPS_SIGNATURE_STATUS。
要求
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | xpsdigitalsignature.h |