IXpsSignature::Verifikasi metode (xpsdigitalsignature.h)

Artikel
08/28/2023

Memverifikasi tanda tangan terhadap sertifikat X.509 tertentu.

Sintaks

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

Parameter

[in] x509Certificate

Struktur CERT_CONTEXT yang berisi sertifikat X.509 yang akan digunakan untuk verifikasi.

Jika tanda tangan tidak lengkap atau tidak sesuai, sertifikat ini hanya akan digunakan untuk memvalidasi bahwa data yang ditandatangani dalam paket XPS utuh. Sertifikat tidak akan digunakan untuk melakukan pemeriksaan lainnya. Sebelum menggunakan sertifikat, aplikasi diharapkan untuk memverifikasi rantai kepercayaan dan persyaratan lainnya.

[out, retval] sigStatus

Nilai XPS_SIGNATURE_STATUS yang menjelaskan hasil verifikasi.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk nilai pengembalian yang tidak tercantum dalam tabel ini, lihat Kesalahan XPS Digital Signature API dan Kesalahan Dokumen XPS.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	x509Certificate atau sigStatus adalah NULL.
E_UNEXPECTED	Antarmuka tidak tersambung ke pengelola tanda tangan.

Keterangan

Metode ini mendeteksi status tanda tangan dalam urutan yang ditentukan di bagian 10.2.1.2 dari Spesifikasi Kertas XML. Urutan deteksi adalah sebagai berikut: tidak patuh, tidak lengkap, rusak, dipertanyakan, dan, akhirnya, valid. Ini berarti bahwa jika, misalnya, tanda tangan ditemukan tidak sesuai, tidak ada hash yang akan dihitung jika tanda tangan juga rusak.

Untuk informasi selengkapnya tentang berbagai jenis status tanda tangan yang dapat dideteksi oleh metode ini, lihat XPS_SIGNATURE_STATUS.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	xpsdigitalsignature.h