Metode IX509ExtensionTemplate::InitializeEncode (certenroll.h)

  • Artikel

Metode InitializeEncode menginisialisasi ekstensi dari pengidentifikasi objek templat (OID) dan dari nomor versi utama dan minor. Metode ini diaktifkan web.

Sintaks

HRESULT InitializeEncode(
  [in] IObjectId *pTemplateOid,
  [in] LONG      MajorVersion,
  [in] LONG      MinorVersion
);

Parameter

[in] pTemplateOid

Penunjuk ke antarmuka IObjectId yang mewakili OID templat.

[in] MajorVersion

Variabel LONG yang berisi nomor versi utama templat. Nilai defaultnya adalah nol (0).

[in] MinorVersion

Variabel LONG yang berisi nomor versi minor templat. Nilai defaultnya adalah nol (0).

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 harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509ExtensionTemplate . Kedua metode saling melengkapi. Metode InitializeEncode memungkinkan Anda membuat objek ekstensi Abstract Syntax Notation One (ASN.1) yang dikodekan Distinguished Encoding Rules (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 MajorVersion dan MinorVersion mengambil informasi versi.
  • Properti TemplateOid mengambil OID templat.

Anda harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509ExtensionBasicConstraints . Kedua metode saling melengkapi. Metode InitializeEncode memungkinkan Anda membuat struktur ASN.1 yang dikodekan dari data mentah, dan metode InitializeDecode memungkinkan Anda menginisialisasi data mentah dari struktur ASN.1 yang dikodekan. Anda dapat mengambil data mentah untuk ekstensi dengan memanggil properti MajorVersion, MinorVersion, dan TemplateOid .

Persyaratan

   
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