ICspStatuses

暗号化プロバイダー/アルゴリズムのペアに関する情報を格納します。(ICspStatuses)

コレクションからインデックス番号で ICspStatus オブジェクトを取得します。

コレクション内の ICspStatus オブジェクトの数を取得します。

コレクションの列挙子を取得します。(ICspStatuses.get__NewEnum)

コレクションに ICspStatus オブジェクトを追加します。

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

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

コレクションからインデックス番号で ICspStatus オブジェクトを削除します。

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

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

コレクションからすべての ICspStatus オブジェクトを削除します。

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

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

コレクションからプロバイダー名とアルゴリズム名で ICspStatus オブジェクトを取得します。

コレクションから序数で ICspStatus オブジェクトを取得します。

コレクション内の ICspStatus オブジェクトの序数順は、コレクションを列挙するたびに、以下を含む（ただしこれらに限定されない）さまざまな理由により変化する可能性があります。

• 証明書要求テンプレートの設定
• 暗号化プロバイダーのプロパティ値
• 秘密キーのプロパティ値

たとえば、証明書要求を作成するために選択されたバージョン 2 テンプレートが、証明書を署名にのみ使用できる（pKIDefaultKeySpec テンプレート属性が XCN_AT_SIGNATURE である）ことと、既定のプロバイダーが Microsoft Enhanced RSA and AES Cryptographic Provider であることを指定していると仮定します。プロバイダーが暗号化アルゴリズムと署名アルゴリズムの両方をサポートしているにもかかわらず、テンプレートが証明書を署名に制限していることに注意してください。つまり、プロバイダーの KeySpec プロパティは XCN_AT_KEYEXCHANGE 定数と XCN_AT_SIGNATURE 定数のビット単位の組み合わせですが、pKIDefaultKeySpec テンプレート属性は XCN_AT_SIGNATURE のみをサポートします。

コレクション内の ICspStatus オブジェクトは、次のように順序付けられます。

• このプロバイダーに対して列挙される ICspStatus オブジェクトのうち、署名アルゴリズム（XCN_AT_SIGNATURE）に関連付けられたものが最初に（低い序数値で）順序付けられ、その Display プロパティと Selected プロパティが有効になります。
  注 pKIDefaultKeySpec テンプレート属性が XCN_AT_KEYEXCHANGE であった場合は、暗号化アルゴリズムが最初に順序付けられます。
• このプロバイダーに対して列挙される ICspStatus オブジェクトのうち、暗号化アルゴリズム（XCN_AT_KEYEXCHANGE）に関連付けられたものは後で（高い序数値で）順序付けられ、その Display プロパティと Selected プロパティは有効になりません。
• 非対称署名アルゴリズム（XCN_AT_SIGNATURE）をサポートしているが指定されたプロバイダーに関連付けられていない、インストール済みのその他すべての CryptoAPI プロバイダーについては、Display プロパティが有効になり、Selected プロパティは有効になりません。
• 非対称暗号化アルゴリズム（XCN_AT_KEYEXCHANGE）をサポートしている、インストール済みのその他すべての CryptoAPI プロバイダーについては、Display プロパティと Selected プロパティは有効になりません。
• インストール済みのすべての Cryptography API: Next Generation (CNG) プロバイダーについては、Display プロパティと Selected プロパティは有効になりません。

別の例として、バージョン 3 テンプレートが特定の 1 つの CNG プロバイダーとアルゴリズムを指定していると仮定します。そのプロバイダー/アルゴリズムのペア（ICspStatus オブジェクト）が最初に順序付けられ、表示が有効かつ選択された状態になります。そのプロバイダーがサポートするその他すべてのアルゴリズムは後で順序付けられ、表示は有効にならず、選択もされません。指定されたアルゴリズムをサポートするその他すべてのプロバイダーはさらに後で順序付けられ、表示は有効になりますが、選択はされません。残りのすべてのプロバイダー/アルゴリズムのペアは、表示が有効にならず、選択もされません。

入力で指定されたプロバイダーと同じ名前かつ同じアルゴリズムを持つが、異なる暗号化操作を識別する ICspStatus オブジェクトを取得します。

入力で指定されたプロバイダーと同じ名前を持つが、異なるキーの使用目的をサポートするアルゴリズムを識別する ICspStatus オブジェクトを取得します。

ItemByProvider プロパティは、入力プロバイダーの名前と一致するが、異なる X509KeySpec 列挙値に関連付けられた ICspStatus オブジェクトを取得します。たとえば、入力プロバイダーの KeySpec 値が XCN_AT_KEYEXCHANGE の場合、ItemByProvider プロパティは、同じプロバイダーで KeySpec 値が XCN_AT_SIGNATURE である ICspStatus オブジェクトを見つけようとします。

KeySpec プロパティはレガシプロバイダーにのみ関連付けられているため、Cryptography API: Next Generation (CNG) プロバイダーを指定した場合、ItemByProvider プロパティは入力されたものと同じ ICspStatus オブジェクトを返します。

このプロパティを使用してコレクションを反復処理するには、次の手順を実行します。

• IX509CertificateRequestPkcs10 インターフェイスの GetCspStatuses メソッドまたは CspStatuses プロパティを呼び出して、ICspStatuses コレクションを取得します。
• ItemByIndex プロパティを呼び出して、コレクションを反復処理します。
• 対象とするプロバイダーを含む、取得された各 ICspStatus 要素について、ItemByProvider を呼び出します。