ICspAlgorithm::GetAlgorithmOid method (certenroll.h)
Metode GetAlgorithmOid mengambil pengidentifikasi objek algoritma (OID). Metode ini diaktifkan web.
Sintaks
HRESULT GetAlgorithmOid(
[in] LONG Length,
[in] AlgorithmFlags AlgFlags,
[out] IObjectId **ppValue
);
Parameter
[in] Length
Variabel LONG yang mengidentifikasi ukuran kunci algoritma enkripsi simetris yang diperlukan. Gunakan parameter ini untuk mengambil algoritma AES tertentu dari API Kriptografi: Penyedia penyimpanan kunci (KSP) Generasi Berikutnya (CNG). KSP hanya dapat mencantumkan satu algoritma bernama AES tetapi mendukung semua varian AES dalam daftar berikut:
- szOID_NIST_AES128_CBC (2.16.840.1.101.3.4.1.2)
- szOID_NIST_AES192_CBC (2.16.840.1.101.3.4.1.22)
- szOID_NIST_AES256_CBC (2.16.840.1.101.3.4.1.42)
- szOID_NIST_AES128_WRAP (2.16.840.1.101.3.4.1.5)
- szOID_NIST_AES192_WRAP (2.16.840.1.101.3.4.1.25)
- szOID_NIST_AES256_WRAP (2.16.840.1.101.3.4.1.45)
Jika Anda menentukan nol untuk parameter Panjang dan AlgoritmaFlagsNone (0x00000000) untuk parameter AlgFlags , OID yang terkait dengan algoritma default akan diambil. Untuk KSP Perangkat Lunak Microsoft dan KSP Kartu Pintar Microsoft, algoritma AES default adalah szOID_NIST_AES128_CBC (2.16.840.1.101.3.4.1.2).
[in] AlgFlags
Nilai enumerasi AlgoritmaFlags yang menentukan apakah akan mencari algoritma pembungkus kunci. Ini bisa menjadi salah satu nilai berikut:
- AlgoritmaFlagsNone
- AlgoritmaFlagsWrap
Menentukan AlgoritmaFlagsWrap menyebabkan metode ini mencari algoritma yang nama tampilannya diakhapi dengan "wrap". Ini termasuk OID berikut:
- szOID_NIST_AES128_WRAP (2.16.840.1.101.3.4.1.5)
- szOID_NIST_AES192_WRAP (2.16.840.1.101.3.4.1.25)
- szOID_NIST_AES256_WRAP (2.16.840.1.101.3.4.1.45)
- XCN_OID_RSA_SMIMEalgCMS3DESwrap (1.2.840.113549.1.9.16.3.6)
- XCN_OID_RSA_SMIMEalgCMSRC2wrap (1.2.840.113549.1.9.16.3.7)
Jika Anda menentukan nol untuk parameter Panjang dan AlgoritmaFlagsNone (0x00000000) untuk parameter AlgFlags , OID yang terkait dengan algoritma default akan diambil. Untuk KSP Perangkat Lunak Microsoft dan KSP Kartu Pintar Microsoft, algoritma AES default adalah szOID_NIST_AES128_CBC (2.16.840.1.101.3.4.1.2).
[out] ppValue
Alamat variabel yang menerima penunjuk ke antarmuka IObjectId yang mewakili OID algoritma.
Mengembalikan 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 |
---|---|
|
OID algoritma tidak dapat ditemukan. |
|
Informasi CSP belum diinisialisasi. Untuk informasi selengkapnya, lihat antarmuka ICspInformation . |
Keterangan
Anda harus memanggil metode InitializeFromName atau metode InitializeFromType pada antarmuka ICspInformation sebelum memanggil GetAlgorithmOid.
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 |