IX509CertificateRequestPkcs7::InitializeDecode method (certenroll.h)
Metode InitializeDecode mendekode objek permintaan PKCS #7 yang ditandatangani atau tidak ditandatangani yang ada dan menggunakannya untuk menginisialisasi objek PKCS #7 baru. Permintaan yang ada terkandung dalam array byte yang telah dikodekan dengan menggunakan Distinguished Encoding Rules (DER) seperti yang didefinisikan oleh standar Abstract Syntax Notation One (ASN.1). Array byte diwakili oleh string yang merupakan urutan biner murni atau dikodekan Unicode.
Sintaks
HRESULT InitializeDecode(
[in] BSTR strEncodedData,
[in] EncodingType Encoding
);
Parameter
[in] strEncodedData
Variabel BSTR yang berisi permintaan yang dikodekan DER.
[in] Encoding
Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang diterapkan ke string input yang berisi permintaan yang dikodekan DER. Nilai defaultnya adalah XCN_CRYPT_STRING_BASE64.
Menampilkan nilai
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 permintaan telah diinisialisasi. |
Keterangan
Metode InitializeDecode :
- Mendekode permintaan PKCS #7 yang ditentukan pada input.
- Menggunakan objek yang didekode untuk membuat permintaan PKCS #10 dalam dengan koleksi berikut:
- Koleksi ICryptAttributes kosong.
- Koleksi IX509Extensions kosong.
- Koleksi IObjectIds kosong untuk ekstensi penting.
- Koleksi IObjectIds kosong untuk atribut dan OID ekstensi yang akan ditekan dari permintaan baru.
- Menambahkan ekstensi yang didekodekan ke koleksi IX509Extensions .
- Menambahkan atribut yang didekodekan ke koleksi ICryptAttributes
- Mengatur properti ClientId .
- Mengatur properti TemplateObjectId .
- Menggunakan tanda tangan pada permintaan PKCS #7 asli untuk membuat objek ISignerCertificate baru.
- Mengambil objek IX509SignatureInformation dari objek ISignerCertificate .
- Menginisialisasi objek IX509SignatureInformation baru dengan menggunakan algoritma tanda tangan dan hash asli.
- Mengatur permintaan PKCS #10 sebagai objek permintaan dalam.
Secara default, metode InitializeDecode mengasumsikan bahwa permintaan sertifikat yang akan didekodekan adalah untuk pengguna akhir. Dimulai dengan Windows 8 dan Windows Server 2012, Anda dapat mengubah perilaku default ini. Setelah membuat instans antarmuka IX509CertificateRequestPkcs7 , panggil InitializeDecode dengan mengatur parameter Pengodean ke XCN_CRYPT_STRING_BINARY dan parameter strEncodedData ke salah satu nilai berikut:
Nilai | Deskripsi |
---|---|
L"ContextMachine" | Permintaan sertifikat yang dikodekan adalah untuk komputer. |
L"ContextUser" | Permintaan sertifikat yang dikodekan adalah untuk pengguna akhir. |
L"ContextAdministratorForceMachine" | Sertifikat yang dikodekan sedang diminta oleh administrator yang bertindak atas nama komputer. |
Kemudian, panggil metode InitializeDecode lagi dengan sertifikat yang dikodekan yang diatur dalam argumen strEncodedData .
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