PFN_CRYPT_GET_SIGNER_CERTIFICATE fungsi panggilan balik (wincrypt.h)

  • Artikel

Fungsi panggilan balik yang disediakan pengguna CryptGetSignerCertificateCallback digunakan dengan struktur CRYPT_VERIFY_MESSAGE_PARA untuk mendapatkan dan memverifikasi sertifikat penanda tangan pesan.

Sintaks

PFN_CRYPT_GET_SIGNER_CERTIFICATE PfnCryptGetSignerCertificate;

PCCERT_CONTEXT PfnCryptGetSignerCertificate(
  [in] void *pvGetArg,
  [in] DWORD dwCertEncodingType,
  [in] PCERT_INFO pSignerId,
  [in] HCERTSTORE hMsgCertStore
)
{...}

Parameter

[in] pvGetArg

Penunjuk ke data yang ditentukan pengguna yang diteruskan ke fungsi verifikasi seperti yang ditentukan dalam struktur CRYPT_VERIFY_MESSAGE_PARA .

[in] dwCertEncodingType

Menentukan jenis pengodean yang digunakan. Selalu dapat diterima untuk menentukan jenis pengodean sertifikat dan pesan dengan menggabungkannya dengan operasi bitwise-OR seperti yang ditunjukkan dalam contoh berikut:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Jenis pengodean yang saat ini ditentukan adalah:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pSignerId

Penunjuk ke struktur CERT_INFO yang berisi penerbit dan nomor seri. Bisa NULL jika tidak ada konten atau penanda tangan.

[in] hMsgCertStore

Handel ke penyimpanan sertifikat yang berisi semua sertifikat dan CRL dalam pesan yang ditandatangani.

Nilai kembali

Jika sertifikat penanda tangan ditemukan, fungsi mengembalikan penunjuk ke CERT_CONTEXT baca-saja. CERT_CONTEXT yang dikembalikan diperoleh baik dari penyimpanan sertifikat atau dibuat menggunakan CertCreateCertificateContext. Dalam kedua kasus, itu harus dikosongkan menggunakan CertFreeCertificateContext. Jika fungsi ini gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Jika pesan tidak berisi konten atau penanda tangan, fungsi dipanggil dengan pSignerId diatur ke NULL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header wincrypt.h