Fungsi CryptHashSessionKey (wincrypt.h)

Artikel
03/03/2024

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 CryptHashSessionKey menghitung hash kriptografi objek kunci sesi . Fungsi ini dapat dipanggil beberapa kali dengan handel hash yang sama untuk menghitung hash beberapa kunci. Panggilan ke CryptHashSessionKey dapat diselingi dengan panggilan ke CryptHashData.

Sebelum memanggil fungsi ini, CryptCreateHash harus dipanggil untuk membuat handel objek hash.

Sintaks

BOOL CryptHashSessionKey(
  [in] HCRYPTHASH hHash,
  [in] HCRYPTKEY  hKey,
  [in] DWORD      dwFlags
);

Parameter

[in] hHash

Handel ke objek hash.

[in] hKey

Handel ke objek kunci yang akan di-hash.

[in] dwFlags

Nilai bendera berikut ditentukan.

Nilai	Makna
CRYPT_LITTLE_ENDIAN 0x00000001	Ketika bendera ini diatur, byte kunci di-hash dalam bentuk little-endian . Perhatikan bahwa secara default (ketika dwFlags adalah nol), byte kunci di-hash dalam bentuk big-endian .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

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

Kode kesalahan yang diawali oleh "NTE" dihasilkan oleh CSP tertentu yang Anda gunakan. Beberapa kemungkinan kode kesalahan mengikuti.

Menampilkan kode	Deskripsi
ERROR_INVALID_HANDLE	Salah satu parameter menentukan handel yang tidak valid.
ERROR_INVALID_PARAMETER	Salah satu parameter berisi nilai yang tidak valid. Ini paling sering merupakan pointer yang tidak valid.
NTE_BAD_ALGID	Handel hHash menentukan algoritma yang tidak didukung CSP ini.
NTE_BAD_FLAGS	Parameter dwFlags bukan nol.
NTE_BAD_HASH	Objek hash yang ditentukan oleh parameter hHash tidak valid.
NTE_BAD_HASH_STATE	Upaya dilakukan untuk menambahkan data ke objek hash yang sudah ditandai "selesai."
NTE_BAD_KEY	Algoritma hash berkunci sedang digunakan, tetapi kunci sesi tidak lagi valid. Kesalahan ini dihasilkan jika kunci sesi dihancurkan sebelum operasi hashing selesai.
NTE_BAD_UID	Konteks CSP yang ditentukan ketika objek hash dibuat tidak dapat ditemukan.
NTE_FAIL	Fungsi gagal dengan cara yang tidak terduga.

Persyaratan

Persyaratan	Nilai
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	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

CryptCreateHash

CryptGenKey

CryptHashData

Fungsi Hash dan Tanda Tangan Digital

Bagikan melalui