ICspAlgorithm::GetAlgorithmOid method (certenroll.h)

Artikel
03/14/2023

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).

Catatan Parameter ini harus nol untuk algoritma apa pun selain algoritma enkripsi simetris.

[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)

Catatan Parameter ini harus nol untuk algoritma apa pun selain algoritma enkripsi simetris.

[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
CERTSRV_E_PROPERTY_EMPTY	OID algoritma tidak dapat ditemukan.
OLE_E_BLANK	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

Lihat juga

ICspAlgorithm

Bagikan melalui