struktur CRYPT_VERIFY_MESSAGE_PARA (wincrypt.h)

Artikel
2023-08-27

Struktur CRYPT_VERIFY_MESSAGE_PARA berisi informasi yang diperlukan untuk memverifikasi pesan yang ditandatangani.

Sintaks

typedef struct _CRYPT_VERIFY_MESSAGE_PARA {
  DWORD                            cbSize;
  DWORD                            dwMsgAndCertEncodingType;
  HCRYPTPROV_LEGACY                hCryptProv;
  PFN_CRYPT_GET_SIGNER_CERTIFICATE pfnGetSignerCertificate;
  void                             *pvGetArg;
  PCCERT_STRONG_SIGN_PARA          pStrongSignPara;
} CRYPT_VERIFY_MESSAGE_PARA, *PCRYPT_VERIFY_MESSAGE_PARA;

Anggota

cbSize

Ukuran struktur ini dalam byte.

dwMsgAndCertEncodingType

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

hCryptProv

Anggota ini tidak digunakan dan harus diatur ke NULL.

Windows Server 2003 dan Windows XP: Handel ke penyedia layanan kriptografi yang akan digunakan untuk memverifikasi pesan yang ditandatangani. CSP yang diidentifikasi oleh handel ini digunakan untuk hashing dan untuk verifikasi tanda tangan. Kecuali ada alasan kuat untuk menggunakan penyedia kriptografi tertentu, atur ke nol untuk menggunakan penyedia RSA atau DSS default.

Jenis data anggota ini adalah HCRYPTPROV.

pfnGetSignerCertificate

Penunjuk ke fungsi panggilan balik yang digunakan untuk mendapatkan konteks sertifikat penanda tangan. Jika NULL, panggilan balik default digunakan. Panggilan balik default mencoba mendapatkan konteks sertifikat penanda tangan dari penyimpanan sertifikat pesan.

Fungsi panggilan balik yang ditentukan aplikasi yang mendapatkan sertifikat penanda tangan dapat digunakan sebagai pengganti default. Ini diteruskan pengidentifikasi sertifikat penanda tangan (penerbit dan nomor serinya) dan handel ke penyimpanan sertifikat pesan yang ditandatangani kriptografinya.

Lihat CryptGetSignerCertificateCallback untuk tanda tangan dan argumen fungsi panggilan balik.

pvGetArg

Argumen untuk diteruskan ke fungsi panggilan balik. Biasanya, ini mendapatkan dan memverifikasi sertifikat penanda tangan pesan.

pStrongSignPara

Penunjuk opsional ke struktur CERT_STRONG_SIGN_PARA yang berisi parameter yang digunakan untuk penandatanganan yang kuat. Jika Anda mengatur anggota ini dan fungsi berhasil memverifikasi tanda tangan, fungsi kemudian akan memeriksa tanda tangan yang kuat. Jika tanda tangan tidak kuat, operasi akan gagal dan mengatur nilai GetLastError ke NTE_BAD_ALGID.

Catatan Anda dapat menggunakan anggota pStrongSignPara hanya jika CRYPT_VERIFY_MESSAGE_PARA_HAS_EXTRA_FIELDS ditentukan dengan menggunakan direktif #define sebelum menyertakan Wincrypt.h. Jika CRYPT_VERIFY_MESSAGE_PARA_HAS_EXTRA_FIELDS ditentukan, Anda harus nol semua bidang yang tidak digunakan.

Windows 8 dan Windows Server 2012: Dukungan untuk anggota ini dimulai.

Keterangan

Struktur ini diteruskan ke fungsi berikut:

Persyaratan

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

Lihat juga

CERT_CONTEXT

CERT_INFO

CryptDecryptAndVerifyMessageSignature

CryptVerifyDetachedMessageSignature

CryptVerifyMessageSignature

Bagikan melalui