IX509ExtensionAlternativeNames::InitializeEncode method (certenroll.h)

  • Artikel

Metode InitializeEncode menginisialisasi ekstensi dari koleksi IAlternativeNames .

Sintaks

HRESULT InitializeEncode(
  [in] IAlternativeNames *pValue
);

Parameter

[in] pValue

Arahkan ke antarmuka IAlternativeNames .

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_SUBJECT_ALT_NAME2 (2.5.29.17) dan mengodekannya dengan menggunakan Distinguished Encoding Rules (DER).

Anda harus memanggil InitializeEncode atau InitializeDecode sebelum Anda dapat menggunakan objek IX509ExtensionAlternativeNames . 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 AlternativeNames mengambil kumpulan nama (data ekstensi 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

IX509ExtensionAlternativeNames