Fungsi BCryptDuplicateHash (bcrypt.h)

Fungsi BCryptDuplicateHash menduplikasi hash yang ada atau objek Kode Autentikasi Pesan (MAC). Objek duplikat berisi semua status dan data yang terkandung dalam objek asli pada titik duplikasi.

Sintaksis

NTSTATUS BCryptDuplicateHash(
  [in]  BCRYPT_HASH_HANDLE hHash,
  [out] BCRYPT_HASH_HANDLE *phNewHash,
  [out] PUCHAR             pbHashObject,
  [in]  ULONG              cbHashObject,
  [in]  ULONG              dwFlags
);

Parameter

[in] hHash

Handel objek hash atau MAC untuk diduplikasi.

[out] phNewHash

Penunjuk ke nilai BCRYPT_HASH_HANDLE yang menerima handel yang mewakili hash duplikat atau objek MAC.

[out] pbHashObject

Penunjuk ke buffer yang menerima hash duplikat atau objek MAC. Parameter cbHashObject berisi ukuran buffer ini. Ukuran buffer ini yang diperlukan dapat diperoleh dengan memanggil fungsi BCryptGetProperty untuk mendapatkan properti BCRYPT_OBJECT_LENGTH. Ini akan memberikan ukuran objek hash untuk algoritma yang ditentukan.

Ketika handel hash duplikat dirilis, kosongkan memori ini.

[in] cbHashObject

Ukurannya, dalam byte, dari pbHashObject buffer.

[in] dwFlags

Sekumpulan bendera yang mengubah perilaku fungsi ini. Tidak ada bendera yang saat ini ditentukan, jadi parameter ini harus nol.

Mengembalikan nilai

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.

Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Mengembalikan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_BUFFER_TOO_SMALL	Ukuran objek hash yang ditentukan oleh parameter cbHashObject tidak cukup besar untuk menahan objek hash.
STATUS_INVALID_HANDLE	Handel hash di parameter hHash tidak valid.
STATUS_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.

Komentar

Fungsi ini berguna saat menghitung hash atau MAC melalui blok data umum. Setelah data umum diproses, objek hash atau MAC dapat diduplikasi, lalu data unik dapat ditambahkan ke objek individual.

Bergantung pada mode prosesor apa yang didukung penyedia, BCryptDuplicateHash dapat dipanggil baik dari mode pengguna atau mode kernel. Pemanggil mode kernel dapat menjalankan baik di PASSIVE_LEVELIRQL atau IRQL DISPATCH_LEVEL. Jika tingkat IRQL saat ini DISPATCH_LEVEL, handel yang disediakan dalam parameter hHash harus berasal dari handel algoritma yang dikembalikan oleh penyedia yang dibuka dengan menggunakan bendera BCRYPT_PROV_DISPATCH, dan penunjuk apa pun yang diteruskan ke fungsi BCryptDestroyKey harus merujuk ke memori yang tidak dipagasi (atau dikunci).

Untuk memanggil fungsi ini dalam mode kernel, gunakan Cng.lib, yang merupakan bagian dari Driver Development Kit (DDK). Windows Server 2008 dan Windows Vista: Untuk memanggil fungsi ini dalam mode kernel, gunakan Ksecdd.lib.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	bcrypt.h
Pustaka	Bcrypt.lib
DLL	Bcrypt.dll