Metode ICertProperty::InitializeFromCertificate (certenroll.h)
Metode InitializeFromCertificate menginisialisasi objek dengan menggunakan nilai properti yang terkait dengan sertifikat yang ada.
Sintaks
HRESULT InitializeFromCertificate(
[in] VARIANT_BOOL MachineContext,
[in] EncodingType Encoding,
[in] BSTR strCertificate
);
Parameter
[in] MachineContext
Nilai VARIANT_BOOL yang menunjukkan apakah penyimpanan sertifikat adalah untuk komputer lokal atau pengguna saat ini. Tentukan VARIANT_TRUE untuk komputer dan VARIANT_FALSE untuk pengguna.
[in] Encoding
Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang diterapkan ke sertifikat yang terkandung dalam parameter strCertificate .
[in] strCertificate
Variabel BSTR yang berisi sertifikat yang dikodekan DER.
Dimulai dengan Windows 7 dan Windows Server 2008 R2, Anda dapat menentukan cetak jempol sertifikat atau nomor seri daripada sertifikat yang dikodekan. Melakukannya menyebabkan fungsi mencari penyimpanan lokal yang sesuai untuk sertifikat yang cocok. Perlu diingat poin-poin berikut:
- BSTR harus berupa jumlah digit heksadesimal yang merata.
- Spasi putih antara pasangan heksadesimal diabaikan.
- Parameter Pengodean harus diatur ke XCN_CRYPT_STRING_HEXRAW.
- Parameter MachineContext menentukan apakah pengguna atau penyimpanan komputer atau keduanya dicari.
- Jika kunci privat diperlukan, hanya penyimpanan pribadi dan permintaan yang dicari.
- Jika kunci privat tidak diperlukan, penyimpanan OS akar dan menengah juga dicari.
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 |
---|---|
|
Sertifikat tidak dapat ditemukan. |
|
Sertifikat ditemukan tetapi kunci privat tidak dapat dimuat. |
Keterangan
Tentukan properti yang akan diinisialisasi dengan memanggil properti PropertyId . Anda dapat memanggil properti RawData untuk mengambil string yang dikodekan yang berisi properti .
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk