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 |