Fungsi CryptHashCertificate (wincrypt.h)

Penting API ini tidak digunakan lagi. Perangkat lunak baru dan yang sudah ada harus mulai menggunakan Cryptography Next Generation API. Microsoft dapat menghapus API ini dalam rilis mendatang.

 

Fungsi CryptHashCertificatemembuat hash seluruh konten sertifikat yang dikodekan termasuk tanda tangannya.

Sintaks

BOOL CryptHashCertificate(
  [in]      HCRYPTPROV_LEGACY hCryptProv,
  [in]      ALG_ID            Algid,
  [in]      DWORD             dwFlags,
  [in]      const BYTE        *pbEncoded,
  [in]      DWORD             cbEncoded,
  [out]     BYTE              *pbComputedHash,
  [in, out] DWORD             *pcbComputedHash
);

Parameter

[in] hCryptProv

Parameter ini tidak digunakan dan harus diatur ke NULL.

Windows Server 2003 dan Windows XP: Handel penyedia layanan kriptografi (CSP) untuk digunakan untuk menghitung hash.

Jenis data parameter ini adalah HCRYPTPROV.

Kecuali ada alasan kuat untuk melewati CSP tertentu di hCryptProv, nol diteruskan. Melewati nol menyebabkan penyedia RSA atau Digital Signature Standard (DSS) default diperoleh sebelum melakukan operasi hash, verifikasi tanda tangan, atau enkripsi penerima.

[in] Algid

Struktur ALG_ID yang menentukan algoritma hash untuk digunakan. Jika Algid adalah nol, algoritma hash default, SHA1, digunakan.

[in] dwFlags

Nilai yang akan diteruskan ke API hash. Untuk detailnya, lihat CryptCreateHash.

[in] pbEncoded

Alamat konten yang dikodekan yang akan di-hash.

[in] cbEncoded

Ukuran, dalam byte, dari konten yang dikodekan.

[out] pbComputedHash

Pointer ke buffer untuk menerima hash komputasi.

Untuk mengatur ukuran informasi ini untuk tujuan alokasi memori, parameter ini bisa NULL. Untuk informasi selengkapnya, lihat Mengambil Data Dengan Panjang Tidak Diketahui.

[in, out] pcbComputedHash

Penunjuk ke DWORD yang berisi ukuran, dalam byte, dari buffer yang diacu oleh parameter pbComputedHash . Saat fungsi kembali, DWORD berisi jumlah byte yang disimpan dalam buffer.

Catatan Saat memproses data yang dikembalikan dalam buffer, aplikasi perlu menggunakan ukuran aktual data yang dikembalikan. Ukuran aktual bisa sedikit lebih kecil dari ukuran buffer yang ditentukan pada input. Pada input, ukuran buffer biasanya ditentukan cukup besar untuk memastikan bahwa data output terbesar yang mungkin akan pas di buffer. Pada output, variabel yang diacu oleh parameter ini diperbarui untuk mencerminkan ukuran aktual data yang disalin ke buffer.

 

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan bukan nol (TRUE).

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

Catatan Kesalahan dari fungsi yang disebut CryptCreateHash, CryptGetHashParam dan CryptHashData mungkin disebarluaskan ke fungsi ini.

 

Persyaratan

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
Pustaka	Crypt32.lib
DLL	Crypt32.dll

Lihat juga

CryptHashPublicKeyInfo

CryptHashToBesigned

Fungsi Manajemen Data