Metode ICertProperty::InitializeDecode (certenroll.h)
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 |
---|---|
|
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:
- ICertPropertyArchived
- ICertPropertyArchivedKeyHash
- ICertPropertyAutoEnroll
- ICertPropertyBackedUp
- ICertPropertyDescription
- ICertPropertyEnrollment
- ICertPropertyFriendlyName
- ICertPropertyKeyProvInfo
- ICertPropertyRenewal
- ICertPropertyRequestOriginator
- ICertPropertySHA1Hash
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 |