Bagikan melalui


Metode IX509PublicKey::ComputeKeyIdentifier (certenroll.h)

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