Fungsi CryptMsgGetAndVerifySigner (wincrypt.h)

Artikel
03/15/2023

Fungsi CryptMsgGetAndVerifySigner memverifikasi tanda tangan pesan kriptografi.

Sintaks

BOOL CryptMsgGetAndVerifySigner(
  [in]                HCRYPTMSG      hCryptMsg,
  [in]                DWORD          cSignerStore,
  [in, optional]      HCERTSTORE     *rghSignerStore,
  [in]                DWORD          dwFlags,
  [out, optional]     PCCERT_CONTEXT *ppSigner,
  [in, out, optional] DWORD          *pdwSignerIndex
);

Parameter

[in] hCryptMsg

Menangani pesan kriptografi.

[in] cSignerStore

Jumlah penyimpanan dalam array rghSignerStore .

[in, optional] rghSignerStore

Array handel penyimpanan sertifikat yang dapat dicari untuk sertifikat penanda tangan.

[in] dwFlags

Menunjukkan penggunaan fungsi tertentu.

Nilai	Makna
CMSG_TRUSTED_SIGNER_FLAG	Penyimpanan di rghSignerStore diasumsikan tepercaya dan mereka adalah satu-satunya toko yang dicari untuk menemukan sertifikat yang sesuai dengan penerbit penanda tangan dan nomor seri. Jika tidak, penyimpanan penanda tangan dapat disediakan untuk melengkapi penyimpanan sertifikat pesan. Jika sertifikat penanda tangan ditemukan, kunci publiknya digunakan untuk memverifikasi tanda tangan pesan.
CMSG_SIGNER_ONLY_FLAG	Kembalikan penanda tangan tanpa melakukan verifikasi tanda tangan.
CMSG_USE_SIGNER_INDEX_FLAG	Hanya penanda tangan yang ditentukan oleh *pdwSignerIndex yang dikembalikan. Jika tidak, ulangi semua penanda tangan hingga tanda tangan diverifikasi atau tidak ada lagi penanda tangan.

[out, optional] ppSigner

Jika tanda tangan diverifikasi, ppSigner diperbarui untuk menunjuk ke konteks sertifikat penanda tangan. Setelah Anda selesai menggunakan sertifikat, bebaskan konteks dengan memanggil fungsi CertFreeCertificateContext . Parameter ini bisa NULL jika aplikasi tidak memerlukan sertifikat penanda tangan.

[in, out, optional] pdwSignerIndex

Jika tanda tangan diverifikasi, pdwSigner diperbarui untuk menunjuk ke indeks penanda tangan dalam array penanda tangan. Parameter ini dapat berupa NULL jika aplikasi tidak memerlukan indeks penanda tangan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol (TRUE).

Jika fungsi gagal, nilai yang dikembalikan adalah nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll

Lihat juga

Fungsi Verifikasi Menggunakan CTL