Metode IX509ExtensionSubjectKeyIdentifier::InitializeEncode (certenroll.h)

  • Artikel

Metode InitializeEncode menginisialisasi ekstensi dari array byte yang berisi pengidentifikasi kunci. Array byte diwakili oleh string yang dikodekan Unicode.

Sintaks

HRESULT InitializeEncode(
  [in] EncodingType Encoding,
  [in] BSTR         strKeyIdentifier
);

Parameter

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang diterapkan ke parameter strKeyIdentifier .

[in] strKeyIdentifier

Variabel BSTR yang berisi pengidentifikasi kunci.

Nilai kembali

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Objek sudah diinisialisasi.

Keterangan

Biasanya, nilai input harus berupa hash SHA-1 dari kunci publik yang terkandung dalam sertifikat penandatanganan otoritas sertifikasi. Metode ini mengaitkan nilai dengan pengidentifikasi objek (OID) XCN_OID_SUBJECT_KEY_IDENTIFIER (2.5.29.14) dan mengodekannya dengan menggunakan Distinguished Encoding Rules (DER).

Anda harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509ExtensionSubjectKeyIdentifier . Kedua metode saling melengkapi. Metode InitializeEncode memungkinkan Anda membuat objek ekstensi Abstract Syntax Notation One (ASN.1) yang dikodekan DER dari data mentah, dan metode InitializeDecode memungkinkan Anda menginisialisasi data mentah dari objek yang dikodekan.

Anda dapat mengambil properti berikut untuk ekstensi ini:

  • Properti Kritis mengidentifikasi apakah ekstensi sangat penting. Anda juga dapat menentukan properti ini.
  • Properti ObjectId mengambil OID.
  • Properti AuthorityKeyIdentifier mengambil data mentah.

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

IX509ExtensionSubjectKeyIdentifier