Metode IX509ExtensionSmimeCapabilities::InitializeDecode (certenroll.h)

  • Artikel

Metode InitializeDecode menginisialisasi ekstensi dari array byte yang dikodekan Distinguished Encoding Rules (DER) yang berisi nilai ekstensi. Array byte yang dikodekan DER 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 parameter strEncodedData .

[in] strEncodedData

Variabel BSTR yang berisi ekstensi yang dikodekan DER.

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

Anda dapat menggunakan metode ini jika Anda memiliki objek ASN.1 yang dikodekan DER yang berisi ekstensi SmimeCapabilities . 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 IX509ExtensionSmimeCapabilities . Kedua metode saling melengkapi. Metode InitializeEncode memungkinkan Anda membuat objek ekstensi 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 ekstensi.
  • Properti SmimeCapabilities mengambil pengumpulan kemampuan (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

IX509ExtensionSmimeCapabilities