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 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 を取得できます。

Requirements

Requirement	価値
サポートされる最小クライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
Header	certenroll.h
DLL	CertEnroll.dll