IX509AttributeRenewalCertificate::InitializeDecode メソッド (certenroll.h)

InitializeDecode メソッドは、更新する証明書を含むDistinguished Encoding Rules (DER) でエンコードされたバイト配列からオブジェクトを初期化します。 バイト配列は、Unicode でエンコードされた文字列で表されます。

構文

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

パラメーター

[in] Encoding

入力文字列に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。

[in] strEncodedData

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

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

• BSTR は偶数の 16 進数である必要があります。
• 16 進数のペア間の空白は無視されます。
• Encoding パラメーターは、XCN_CRYPT_STRING_HEXRAWに設定する必要があります。
• 秘密キーが必要な場合は、個人用ストアと要求ストアのみが検索されます。
• 秘密キーが必要ない場合は、ルートおよび中間 CA ストアも検索されます。

戻り値

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

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

注釈

この属性の オブジェクト識別子 (OID) は XCN_OID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1) です。 詳細については、「 CERTENROLL_OBJECTID」を参照してください。

このメソッドは、属性値を含む DER でエンコードされた Abstract Syntax Notation One (ASN.1) オブジェクトがある場合に使用できます。 DER でエンコードされたオブジェクトは、Unicode でエンコードされた文字列で指定する必要があります。 詳細については、 IBinaryConverter インターフェイスを参照してください。

IX509AttributeRenewalCertificate オブジェクトを使用するには、InitializeEncode または InitializeDecode を呼び出す必要があります。 2 つのメソッドは相互に補完し合います。 InitializeEncode メソッドを使用すると、エンコードされた ASN.1 構造体を生データから構築できます。InitializeDecode メソッドを使用すると、エンコードされた ASN.1 構造体から生データを初期化できます。 RenewalCertificate プロパティを呼び出して、生データを取得できます。

要件

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

こちらもご覧ください

IX509AttributeRenewalCertificate