Metode IX509ExtensionBasicConstraints::InitializeEncode (certenroll.h)

  • Artikel

Metode InitializeEncode menginisialisasi ekstensi dari nilai Boolean yang menunjukkan apakah subjek sertifikat adalah otoritas sertifikasi (CA) dan bilangan bulat yang berisi kedalaman rantai CA bawahan.

Sintaks

HRESULT InitializeEncode(
  [in] VARIANT_BOOL IsCA,
  [in] LONG         PathLenConstraint
);

Parameter

[in] IsCA

Variabel VARIANT_BOOL yang menentukan apakah subjek sertifikat adalah CA.

[in] PathLenConstraint

Variabel LONG yang berisi jumlah maksimum sertifikat dalam rantai.

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

Metode ini mengaitkan kumpulan nama dengan pengidentifikasi objek (OID) XCN_OID_BASIC_CONSTRAINTS2 (2.5.29.19) dan mengodekannya dengan menggunakan Distinguished Encoding Rules (DER).

Anda harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509ExtensionBasicConstraints . 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 IsCA mengidentifikasi apakah subjek sertifikat dapat menjadi otoritas sertifikasi.
  • Properti PathLenConstraint mengidentifikasi kedalaman rantai otoritas sertifikasi bawahan.

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

IX509ExtensionBasicConstraints