Bagikan melalui

Metode ICertProperty::InitializeDecode (certenroll.h)

  • Artikel

Metode InitializeDecode menginisialisasi objek dari array byte yang berisi nilai properti. 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 nilai properti yang dikodekan Distinguished Encoding Rules (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

Tentukan properti yang akan diinisialisasi dengan memanggil properti PropertyId . Anda dapat memanggil properti RawData untuk mengambil nilai properti yang dikodekan. Panggil metode SetValueOnCertificate untuk mengaitkan nilai properti dengan sertifikat.

Jika metode InitializeDecode gagal, objek ICertProperty tidak diinisialisasi dan nilai properti input tidak disimpan. Namun, properti PropertyId mempertahankan pengidentifikasi yang ditentukan.

Metode InitializeDecode disediakan untuk memungkinkan Anda menginisialisasi properti kustom dan properti yang diidentifikasi dalam enumerasi CERTENROLL_PROPERTYID yang tidak ada antarmuka tertentu. Setiap nilai yang didukung dalam enumerasi tersebut berisi informasi tentang jenis data, biasanya CRYPT_INTEGER_BLOB, yang harus Anda berikan ke metode InitializeDecode . Anda dapat menggunakan antarmuka IBinaryConverter untuk mengonversi array byte menjadi string.

Antarmuka berikut menyederhanakan pembuatan properti yang paling umum:

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

ICertProperties

ICertProperty