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

Initialize メソッドは、署名証明書からオブジェクトを初期化します。

構文

HRESULT Initialize(
  [in] VARIANT_BOOL         MachineContext,
  [in] X509PrivateKeyVerify VerifyType,
  [in] EncodingType         Encoding,
  [in] BSTR                 strCertificate
);

パラメーター

[in] MachineContext

ローカル コンピューターの証明書ストア コンテキストまたはユーザー コンテキストを検索して strCertificate パラメーターで識別される証明書を検索するかどうかを示すVARIANT_BOOL変数。 コンピューター のVARIANT_TRUE とユーザーの VARIANT_FALSE を指定します。

[in] VerifyType

証明書の署名に使用される秘密キーを検証する必要があるかどうかを示す X509PrivateKeyVerify 列挙値。検証がサイレントであるか、ユーザー入力を許可する必要があるかを示します。

[in] Encoding

識別エンコード規則 (DER) でエンコードされた証明書文字列に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。

[in] strCertificate

DER でエンコードされた証明書を含む BSTR 変数。

Windows 7 および Windows Server 2008 R2 以降では、エンコードされた証明書ではなく、証明書のサムプリントまたはシリアル番号を指定できます。 これにより、関数は適切なローカル ストアで一致する証明書を検索します。 以下の点に注意してください。

• BSTR は偶数の 16 進数である必要があります。
• 16 進数のペア間の空白は無視されます。
• Encoding パラメーターは、XCN_CRYPT_STRING_HEXRAWに設定する必要があります。
• MachineContext パラメーターは、ユーザーまたはコンピューターストア、またはその両方を検索するかどうかを決定します。
• 秘密キーが必要な場合は、個人用ストアと要求ストアのみが検索されます。
• 秘密キーが必要ない場合は、ルートおよび中間 CA ストアも検索されます。

戻り値

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

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

注釈

Initialize メソッド:

• 証明書に関連付けられている秘密キーが存在するかどうかを確認します。
• IX509SignatureInformation オブジェクトを作成し、それを ISignerCertificate オブジェクトに割り当てます。
• 秘密キーから公開キー アルゴリズムを取得します。
• 公開キー アルゴリズムを IX509SignatureInformation オブジェクトに 割り当てます。

Initialize を呼び出す前に、次のプロパティを設定します。

• ParentWindow
• ピン
• Silent
• UIContextMessage

Requirements

こちらも参照ください

ISignerCertificate