IX509PublicKey::Initialize メソッド (certenroll.h)

Initialize メソッドは、公開キー アルゴリズム オブジェクト識別子 (OID) と公開キーと関連付けられたパラメーターを含むバイト配列 (存在する場合) からオブジェクトを初期化します。 バイト配列は、Unicode でエンコードされた文字列で表されます。

構文

HRESULT Initialize(
  [in] IObjectId    *pObjectId,
  [in] BSTR         strEncodedKey,
  [in] BSTR         strEncodedParameters,
  [in] EncodingType Encoding
);

パラメーター

[in] pObjectId

アルゴリズム OID を表す IObjectId インターフェイスへのポインター。

[in] strEncodedKey

公開キーを含む BSTR 変数。

[in] strEncodedParameters

公開キーに関連付けられているパラメーターを含む BSTR 変数。 詳細については、「 EncodedParameters プロパティ」を参照してください。

[in] Encoding

strEncodedKey パラメーターと strEncodedParameters パラメーターで指定された引数に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。 既定値は XCN_CRYPT_STRING_BASE64 です。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

リターン コード/値	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	オブジェクトは既に初期化されています。

解説

Initialize メソッドは、次のプロパティ値を初期化します。

• アルゴリズム
• EncodedKey
• EncodedParameters
• [データ型]

要件

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

関連項目

IX509PublicKey