Fungsi CertIsStrongHashToSign (wincrypt.h)

Artikel
03/03/2024

Menentukan apakah algoritma hash yang ditentukan dan kunci umum dalam sertifikat penandatanganan dapat digunakan untuk melakukan penandatanganan yang kuat.

Sintaks

BOOL CertIsStrongHashToSign(
  [in]           PCCERT_STRONG_SIGN_PARA pStrongSignPara,
  [in]           LPCWSTR                 pwszCNGHashAlgid,
  [in, optional] PCCERT_CONTEXT          pSigningCert
);

Parameter

[in] pStrongSignPara

Penunjuk ke struktur CERT_STRONG_SIGN_PARA yang berisi informasi tentang algoritma penandatanganan dan hash yang didukung.

[in] pwszCNGHashAlgid

Penunjuk ke string Unicode yang berisi nama algoritma hashing. Algoritma berikut didukung:

L"MD5" (BCRYPT_MD5_ALGORITHM)
L"SHA1" (BCRYPT_SHA1_ALGORITHM)
L"SHA256" (BCRYPT_SHA256_ALGORITHM)
L"SHA256" (BCRYPT_SHA256_ALGORITHM)
L"SHA512" (BCRYPT_SHA512_ALGORITHM)

[in, optional] pSigningCert

Penunjuk ke struktur CERT_CONTEXT yang berisi sertifikat penandatanganan. Algoritma kunci publik dalam sertifikat penandatanganan diperiksa kekuatannya. Algoritma kunci umum (asimetris) digunakan untuk penandatanganan. Algoritma tanda tangan berikut didukung:

L"RSA" (BCRYPT_RSA_ALGORITHM)
L"DSA" (BCRYPT_DSA_ALGORITHM)
L"ECDSA" (SSL_ECDSA_ALGORITHM)

Parameter ini bisa NULL jika Anda ingin memeriksa hanya apakah algoritma hashing kuat.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Fungsi ini memiliki kode kesalahan berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen input tidak benar.
NTE_BAD_ALGID	Algoritma yang ditentukan tidak didukung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll

Lihat juga

CERT_STRONG_SIGN_PARA

Bagikan melalui