IX509Extension::Initialize method (certenroll.h)

  • Artikel

Metode Inisialisasi menginisialisasi objek IX509Extension dengan menggunakan pengidentifikasi objek (OID) dan array byte yang berisi ekstensi yang dikodekan Distinguished Encoding Rules (DER). Array byte yang dikodekan DER diwakili oleh string yang dikodekan Unicode. Metode ini diaktifkan web.

Sintaks

HRESULT Initialize(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parameter

[in] pObjectId

Penunjuk ke antarmuka IObjectId yang berisi OID ekstensi.

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang diterapkan ke string input.

[in] strEncodedData

Variabel BSTR yang berisi nilai 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
CERTSRV_E_PROPERTY_EMPTY
 OID tidak dapat ditemukan.

Keterangan

Ekstensi sertifikat terdiri dari OID, nilai Boolean yang mengidentifikasi apakah ekstensi sangat penting, dan array byte yang berisi nilai ekstensi. Ekstensi didefinisikan oleh standar Abstract Syntax Notation One (ASN.1) dan dikodekan dengan menggunakan DER. Anda harus menentukan array byte yang dikodekan DER sebagai string yang merupakan urutan biner murni atau dikodekan Unicode. Anda dapat menentukan jenis pengodean untuk diterapkan ke string dengan menggunakan enumerasi EncodingType .

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

IX509Extension