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 Paper Specification

XPS 數位簽章 API 錯誤

XPS 檔錯誤

XPS_SIGNATURE_STATUS