Metode IX509AttributeRenewalCertificate::InitializeDecode (certenroll.h)

Artikel
03/04/2024

Metode InitializeDecode menginisialisasi objek dari array byte yang dikodekan Distinguished Encoding Rules (DER) yang berisi sertifikat yang akan diperbarui. Array byte 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 string input.

[in] strEncodedData

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 dapat menggunakan metode ini jika Anda memiliki objek Abstract Syntax Notation One (ASN.1) yang dikodekan DER yang berisi nilai atribut. 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 IX509AttributeRenewalCertificate . 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 memanggil properti RenewalCertificate untuk 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

Lihat juga

IX509AttributeRenewalCertificate

Bagikan melalui