ICertProperty::InitializeFromCertificate メソッド (certenroll.h)

InitializeFromCertificate メソッドは、既存の証明書に関連付けられているプロパティ値を使用してオブジェクトを初期化します。

構文

HRESULT InitializeFromCertificate(
  [in] VARIANT_BOOL MachineContext,
  [in] EncodingType Encoding,
  [in] BSTR         strCertificate
);

[in] MachineContext

証明書ストアがローカルコンピューター用か現在のユーザー用かを示す VARIANT_BOOL 値。コンピューター のVARIANT_TRUE とユーザーの VARIANT_FALSE を指定します。

[in] Encoding

strCertificate パラメーターに含まれる証明書に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。

[in] strCertificate

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

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

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

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

リターンコード/値	Description
CRYPT_E_NOT_FOUND	証明書が見つかりませんでした。
CRYPT_E_UNEXPECTED_MSG_TYPE	証明書が見つかりましたが、秘密キーを読み込めませんでした。

PropertyId プロパティを呼び出して、初期化するプロパティを指定します。 RawData プロパティを呼び出して、プロパティを含むエンコードされた文字列を取得できます。