ISmimeCapability::Inisialisasi metode (certenroll.h)
Metode Inisialisasi menginisialisasi objek dari pengidentifikasi objek algoritma enkripsi simetris (OID) dan panjang kunci opsional.
Sintaks
HRESULT Initialize(
[in] IObjectId *pObjectId,
[in] LONG BitCount
);
Parameter
[in] pObjectId
Penunjuk ke antarmuka IObjectId yang mewakili OID.
[in] BitCount
Variabel LONG yang berisi panjang bit kunci konten.
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 |
|---|---|
|
Penunjuk IObjectId adalah NULL. |
Keterangan
Algoritma enkripsi simetris berikut didukung oleh API Pendaftaran Sertifikat. Hanya algoritma RC2 dan RC4 yang memiliki panjang kunci variabel yang dapat ditentukan.
| OID | Panjang kunci | Deskripsi |
|---|---|---|
| XCN_OID_OIWSEC_desCBC1.3.14.3.2.7 | 56 | Ukuran kuncinya adalah algoritma DES CBC adalah 56 bit. Anda tidak perlu menentukan nilai ini. |
| XCN_OID_RSA_DES_EDE3_CBC1.2.840.113549.3.7 | 168 | Ukuran kuncinya adalah algoritma 3DES CBC adalah 168 bit. Anda tidak perlu menentukan nilai ini. |
| XCN_OID_RSA_RC2CBC1.2.840.113549.3.2 | 40 hingga 128 | RC4 adalah algoritma kunci variabel. nilai umum adalah 40, 64, dan 128 bit. |
| XCN_OID_RSA_RC41.2.840.113549.3.4 | 40 hingga 128 | RC4 adalah algoritma kunci variabel. nilai umum adalah 40, 64, dan 128 bit. |
| XCN_OID_RSA_SMIMEalgCMS3DESwrap1.2.840.113549.1.9.16.3.6 | 168 | Ukuran kunci algoritma pembungkus kunci MMS Data Encryption Standard (DES) adalah 168 bit. Anda tidak perlu menentukan nilai ini. |
| XCN_OID_RSA_SMIMEalgCMSRC2wrap1.2.840.113549.1.9.16.3.7 | 128 | Ukuran kunci algoritma pembungkus kunci MMS RC2 adalah 128 bit. Anda tidak perlu menentukan nilai ini. |
| XCN_OID_NIST_AES128_CBC2.16.840.1.101.3.4.1.2 | 128 | Ukuran kunci disiratkan oleh OID. Anda tidak perlu menentukan nilai ini. |
| XCN_OID_NIST_AES192_CBC2.16.840.1.101.3.4.1.22 | 192 | Ukuran kunci disiratkan oleh OID. Anda tidak perlu menentukan nilai ini. |
| XCN_OID_NIST_AES256_CBC2.16.840.1.101.3.4.1.42 | 256 | Ukuran kunci disiratkan oleh OID. Anda tidak perlu menentukan nilai ini. |
| XCN_OID_NIST_AES128_WRAP2.16.840.1.101.3.4.1.5 | 128 | Ukuran kunci disiratkan oleh OID. Anda tidak perlu menentukan nilai ini. |
| XCN_OID_NIST_AES192_WRAP2.16.840.1.101.3.4.1.25 | 192 | Ukuran kunci disiratkan oleh OID. Anda tidak perlu menentukan nilai ini. |
| XCN_OID_NIST_AES256_WRAP2.16.840.1.101.3.4.1.45 | 256 | Ukuran kunci disiratkan oleh OID. Anda tidak perlu menentukan nilai ini. |
Panjang kunci yang Anda tentukan untuk algoritma RC2 dan RC4 harus konsisten dengan yang didukung oleh penyedia atau penyedia kriptografi yang digunakan oleh klien. Untuk informasi selengkapnya, lihat ICspInformation. Anda dapat mengambil panjang bit dengan memanggil properti BitCount , dan Anda dapat mengambil OID algoritma dengan memanggil properti ObjectId .
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 |