ISmimeCapability：：Initialize 方法 (certenroll.h)

Initialize 方法會從對稱加密演算法物件識別元初始化物件， (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 支援下列對稱加密演算法。只有 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。