Metode IX509ExtensionSubjectKeyIdentifier::InitializeEncode (certenroll.h)
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 |
---|---|
|
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 |