Metode IX509ExtensionTemplate::InitializeDecode (certenroll.h)

Artikel
03/14/2023

Metode InitializeDecode menginisialisasi ekstensi dari array byte yang dikodekan DER yang berisi nilai ekstensi. Array byte yang dikodekan diwakili oleh string yang dikodekan Unicode.

Sintaks

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parameter

[in] Encoding

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

[in] strEncodedData

Variabel BSTR yang berisi ekstensi yang dikodekan DER.

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

Keterangan

Anda dapat menggunakan metode ini jika Anda memiliki objek Abstract Syntax Notation One (ASN.1) yang dikodekan Distinguished Encoding Rules (DER) yang berisi ekstensi CertificateTemplate. Anda harus menyediakan objek yang dikodekan DER dalam string yang dikodekan Unicode. Untuk informasi selengkapnya, lihat antarmuka IBinaryConverter .

Anda harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509ExtensionTemplate . Kedua metode saling melengkapi. Metode InitializeEncode memungkinkan Anda membuat objek ekstensi 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 pengidentifikasi objek (OID).
Properti MajorVersion dan MinorVersion mengambil informasi versi.
Properti TemplateOid mengambil OID templat.

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

IX509ExtensionTemplate

Bagikan melalui