初始化方法則是從對稱加密演算法的物件識別碼(OID)及可選的金鑰長度初始化物件。
語法
HRESULT Initialize(
[in] IObjectId *pObjectId,
[in] LONG BitCount
);
參數
[in] pObjectId
指標指向代表 OID 的 IObjectId 介面。
[in] BitCount
一個包含對稱密鑰位元長度的 LONG 變數。
返回值
如果函式成功,函式會傳回 S_OK。
如果函式失敗,它會傳回指出錯誤的 HRESULT 值。 可能的值包括但不限於下表中的值。 如需常見錯誤碼的清單,請參閱 常見的 HRESULT 值。
| 傳回碼/值 | Description |
|---|---|
|
IObjectId 指標是 NULL。 |
備註
以下對稱加密演算法由憑證註冊 API 支援。 只有 RC2 和 RC4 演算法擁有可變的鍵長可指定。
| 物件識別 (OID) | 金鑰長度 | Description |
|---|---|---|
| XCN_OID_OIWSEC_desCBC1.3.14.3.2.7 | 56 | DES CBC 演算法的金鑰大小為 56 位元。 你不需要指定這個數值。 |
| XCN_OID_RSA_DES_EDE3_CBC1.2.840.113549.3.7 | 168 | 3DES CBC 演算法的密鑰大小為 168 位元。 你不需要指定這個數值。 |
| XCN_OID_RSA_RC2CBC1.2.840.113549.3.2 | 40 到 128 | RC4 是一種變數鍵演算法。 常見的數值有 40、64 和 128 位元。 |
| XCN_OID_RSA_RC41.2.840.113549.3.4 | 40 到 128 | RC4 是一種變數鍵演算法。 常見的數值有 40、64 和 128 位元。 |
| XCN_OID_RSA_SMIMEalgCMS3DESwrap1.2.840.113549.1.9.16.3.6 | 168 | MMS 資料加密標準 (DES)金鑰包裝演算法的金鑰大小為 168 位元。 你不需要指定這個數值。 |
| XCN_OID_RSA_SMIMEalgCMSRC2wrap1.2.840.113549.1.9.16.3.7 | 128 | MMS RC2 金鑰包裹演算法的密鑰大小為 128 位元。 你不需要指定這個數值。 |
| XCN_OID_NIST_AES128_CBC2.16.840.1.101.3.4.1.2 | 128 | 鍵大小由 OID 隱含。 你不需要指定這個數值。 |
| XCN_OID_NIST_AES192_CBC2.16.840.1.101.3.4.1.22 | 192 | 鍵大小由 OID 隱含。 你不需要指定這個數值。 |
| XCN_OID_NIST_AES256_CBC2.16.840.1.101.3.4.1.42 | 256 | 鍵大小由 OID 隱含。 你不需要指定這個數值。 |
| XCN_OID_NIST_AES128_WRAP2.16.840.1.101.3.4.1.5 | 128 | 鍵大小由 OID 隱含。 你不需要指定這個數值。 |
| XCN_OID_NIST_AES192_WRAP2.16.840.1.101.3.4.1.25 | 192 | 鍵大小由 OID 隱含。 你不需要指定這個數值。 |
| XCN_OID_NIST_AES256_WRAP2.16.840.1.101.3.4.1.45 | 256 | 鍵大小由 OID 隱含。 你不需要指定這個數值。 |
你為 RC2 和 RC4 演算法指定的金鑰長度,必須與客戶端所使用的密碼提供商所支援的長度一致。 欲了解更多資訊,請參閱 ICspInformation。 你可以透過呼叫 BitCount 屬性來取得位元長度,也可以透過呼叫 ObjectId 屬性來取得演算法 OID。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | certenroll.h |
| DLL | CertEnroll.dll |