Share via

IX509AttributeRenewalCertificate::InitializeEncode method (certenroll.h)

  • Artikel

Metode InitializeEncode menginisialisasi atribut dengan menggunakan sertifikat yang akan diperbarui. Sertifikat harus dikodekan dengan menggunakan Distinguished Encoding Rules (DER).

Sintaks

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

Parameter

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang diterapkan ke sertifikat yang terkandung dalam parameter strCert .

[in] strCert

Variabel BSTR yang berisi sertifikat yang dikodekan DER.

Dimulai dengan Windows 7 dan Windows Server 2008 R2, Anda dapat menentukan cetak jempol sertifikat atau nomor seri daripada sertifikat yang dikodekan. Melakukannya menyebabkan fungsi mencari penyimpanan lokal yang sesuai untuk sertifikat yang cocok. Perlu diingat poin-poin berikut:

  • BSTR harus berupa jumlah digit heksadesimal yang merata.
  • Spasi putih antara pasangan heksadesimal diabaikan.
  • Parameter Pengodean harus diatur ke XCN_CRYPT_STRING_HEXRAW.
  • Jika kunci privat diperlukan, hanya penyimpanan pribadi dan permintaan yang dicari.
  • Jika kunci privat tidak diperlukan, penyimpanan OS akar dan menengah juga dicari.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Pengidentifikasi objek (OID) untuk atribut ini XCN_OID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1). Untuk informasi selengkapnya, lihat CERTENROLL_OBJECTID.

Anda harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509AttributeRenewalCertificate . Kedua metode saling melengkapi. Metode InitializeEncode memungkinkan Anda membuat struktur Abstract Syntax Notation One (ASN.1) yang dikodekan dari data mentah, dan metode InitializeDecode memungkinkan Anda menginisialisasi data mentah dari struktur ASN.1 yang dikodekan. Anda dapat memanggil properti RenewalCertificate untuk mengambil data mentah.

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

IX509AttributeRenewalCertificate