Metode IX509PublicKey::ComputeKeyIdentifier (certenroll.h)

Artikel
02/23/2024

Metode ComputeKeyIdentifier membuat pengidentifikasi dari hash SHA-1 160-bit dari kunci publik.

Sintaks

HRESULT ComputeKeyIdentifier(
  [in]  KeyIdentifierHashAlgorithm Algorithm,
  [in]  EncodingType               Encoding,
  [out] BSTR                       *pValue
);

Parameter

[in] Algorithm

Nilai enumerasi KeyIdentifierHashAlgorithm yang menentukan algoritma hash apa yang akan digunakan untuk membuat pengidentifikasi kunci.

Jika nilai ini adalah SKIHashDefault atau SKIHashSha1, pengidentifikasi dibuat dengan hanya hashing array byte yang berisi kunci dan tidak termasuk tag Distinguished Encoding Rules (DER), panjang, dan bidang bit yang tidak digunakan.

Jika nilai ini adalah SKIHashCapiSha1, pengidentifikasi dibuat dengan hash array byte yang dikodekan DER yang berisi tag, panjang, jumlah bit yang tidak digunakan, dan kunci publik.

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang akan diterapkan ke hash yang terkandung dalam parameter pValue . Nilai defaultnya adalah XCN_CRYPT_STRING_BASE64.

[out] pValue

Penunjuk ke variabel BSTR yang berisi pengidentifikasi kunci.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Mengembalikan kode/nilai	Deskripsi
CERTSRV_E_PROPERTY_EMPTY	Pengidentifikasi objek algoritma atau parameter kunci publik tidak dapat ditemukan.

Keterangan

Anda harus memanggil metode InitializeFromEncodedPublicKeyInfo atau metode Inisialisasi untuk menginisialisasi objek kunci publik sebelum memanggil ComputeKeyIdentifier.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	certenroll.h
DLL	CertEnroll.dll

Lihat juga

IX509PublicKey

Bagikan melalui