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 キーの長さ 説明
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 Data Encryption Standard (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 を取得できます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certenroll.h
[DLL] CertEnroll.dll

こちらもご覧ください

ISmimeCapabilities

ISmimeCapability

IX509ExtensionSmimeCapabilities