共用方式為


ISmimeCapability::Initialize 方法(certenroll.h)

初始化方法則是從對稱加密演算法的物件識別碼(OID)及可選的金鑰長度初始化物件。

語法

HRESULT Initialize(
  [in] IObjectId *pObjectId,
  [in] LONG      BitCount
);

參數

[in] pObjectId

指標指向代表 OID 的 IObjectId 介面。

[in] BitCount

一個包含對稱密鑰位元長度的 LONG 變數。

返回值

如果函式成功,函式會傳回 S_OK

如果函式失敗,它會傳回指出錯誤的 HRESULT 值。 可能的值包括但不限於下表中的值。 如需常見錯誤碼的清單,請參閱 常見的 HRESULT 值

傳回碼/值 Description
CERTSRV_E_PROPERTY_EMPTY
IObjectId 指標是 NULL。

備註

以下對稱加密演算法由憑證註冊 API 支援。 只有 RC2RC4 演算法擁有可變的鍵長可指定。

物件識別 (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

另請參閱

ISmimeCapabilities

ISmimeCapability

IX509ExtensionSmimeCapabilities