IX509SignatureInformation::get_Parameters メソッド (certenroll.h)

Parameters プロパティは、シグネチャ アルゴリズムに関連付けられているパラメーターを含むバイト配列を取得します。 バイト配列は、Unicode でエンコードされた文字列で表されます。

このプロパティは読み取り/書き込み可能です。

構文

HRESULT get_Parameters(
  EncodingType Encoding,
  BSTR         *pValue
);

パラメーター

Encoding

pValue

戻り値

なし

解説

X.509 バージョン 3 証明書のさまざまなフィールドで使用される AlgorithmIdentifier ASN.1 オブジェクトには、アルゴリズム オブジェクト識別子 (OID) と省略可能なパラメーターが含まれています。

AlgorithmIdentifier  ::=  SEQUENCE  
{
   algorithm               OBJECT IDENTIFIER,
   parameters              ANY DEFINED BY algorithm OPTIONAL  
}

パラメーターの形式と内容はアルゴリズムによって異なります。 証明書登録コントロールは、必要に応じてパラメーター情報を生成します。 さまざまなアルゴリズムに対して生成されるパラメーター値については、次のセクションで説明します。

PKCS #1 バージョン 1.5 署名アルゴリズム:

次の OID には NULL パラメーター値が必要です。

• XCN_OID_RSA_MD2RSA (1.2.840.113549.1.1.2)
• XCN_OID_RSA_MD5RSA (1.2.840.113549.1.1.4)
• XCN_OID_RSA_SHA1RSA (1.2.840.113549.1.1.5)
• XCN_OID_RSA_SHA256RSA (1.2.840.113549.1.1.11)
• XCN_OID_RSA_SHA384RSA (1.2.840.113549.1.1.12)
• XCN_OID_RSA_SHA512RSA (1.2.840.113549.1.1.13)

ASN.1 NULL 値は 2 バイトで表されます。 タグ番号が0x05され、パラメーターの長さを表すタグに関連付けられている値が0x00。 これは、次の証明書の例で示されています。

...
Public Key Algorithm:
    Algorithm ObjectId: 1.2.840.113549.1.1.1 RSA (RSA_SIGN)
    Algorithm Parameters:
    05 00
...

RSASSA-PSS 署名:

RSASSA-PSS (RSA Signature Scheme with Appendix - Probabilistic Signature Scheme)、XCN_OID_RSA_SSA_PSS (1.2.840.113549.1.1.10) は、次のパラメーター情報を生成します。 付録を含む署名スキームは、署名の生成と署名の検証操作で構成されます。 署名の検証には、署名が生成された元の証明書要求が必要です。 詳細については、RSA ラボの PKCS #1 v2.1 暗号化標準を参照してください。

RSASSA-PSS-params ::= SEQUENCE 
{
   hashAlgorithm     [0] HashAlgorithm DEFAULT sha1,
   maskGenAlgorithm  [1] MaskGenAlgorithm DEFAULT mgf1SHA1,
   saltLength        [2] INTEGER DEFAULT 20,
   trailerField      [3] TrailerField DEFAULT trailerFieldBC
}

ECDSA-SHA1 署名アルゴリズム: XCN_OID_ECDSA_SHA1 (1.2.840.10045.4.1) を使用して署名を作成すると、パラメーターにはハッシュ アルゴリズムの OID が含まれます。 次の OID がサポートされています。

• XCN_OID_ECDSA_SHA256 (1.2.840.10045.4.3.2)
• XCN_OID_ECDSA_SHA384 (1.2.840.10045.4.3.3)
• XCN_OID_ECDSA_SHA512 (1.2.840.10045.4.3.4)

要件

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

関連項目

IX509SignatureInformation