ICspInformation

暗号化プロバイダーに関する一般的な情報へのアクセスを提供します。

プロバイダー名を含む文字列からオブジェクトを初期化します。

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

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

InitializeFromName メソッドは、指定された名前のプロバイダーを開き、それに問い合わせて ICspInformation オブジェクトに次のプロパティ値を設定します。

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• Name
• Type
• Valid
• Version

このメソッドは、利用可能なアルゴリズムを CspAlgorithms プロパティが返す ICspAlgorithms コレクションに追加します。プロバイダーの種類からオブジェクトを初期化するには、InitializeFromType メソッドを呼び出します。

既定の暗号化プロバイダーからオブジェクトを初期化します。

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

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

InitializeFromType メソッドは、指定された種類を検証して Type プロパティに保存し、既定のプロバイダーを取得して、ICspInformation オブジェクトに次のプロパティ値を設定します。

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• Name
• Valid
• Version

このメソッドは、利用可能なアルゴリズムを CspAlgorithms プロパティが返す ICspAlgorithms コレクションに追加します。CSP 名からオブジェクトを初期化するには、InitializeFromName メソッドを呼び出します。

プロバイダーがサポートするアルゴリズムに関する情報を含む ICspAlgorithm インターフェイスのコレクションを取得します。

ICspAlgorithm オブジェクトには、プロバイダーがサポートする暗号化アルゴリズムに関する情報が含まれます。これには、アルゴリズムの オブジェクト識別子 (OID)、許可されるキーの長さおよび増分長、アルゴリズム名と略称、そしてアルゴリズム OID オブジェクトが有効かどうかを示すブール値が含まれます。

暗号化操作用のランダム バイトを生成するために使用できるハードウェア乱数ジェネレーターをプロバイダーがサポートするかどうかを示すブール値を取得します。

現在、この機能をサポートする Microsoft の暗号化プロバイダーはありません。

プロバイダーがハードウェア デバイスに実装されているかどうかを判断するブール値を取得します。

このプロパティは、プロバイダーがハードウェアに実装されているかどうかのみを示します。プロバイダーはハードウェアとソフトウェアの両方に実装できるため、このプロパティが true であってもソフトウェア コンポーネントが存在しないとは限りません。IsSoftwareDevice プロパティも確認する必要があります。次のプロバイダーは IsHardwareDevice プロパティに true を返します。

• Microsoft Smart Card Key Storage Provider
• Microsoft Base Smart Card Crypto Provider

これらのプロバイダーはいずれも IsSoftwareDevice プロパティにも true を返します。証明書登録サービスは、IsHardwareDevice プロパティと IsSoftwareDevice プロパティの両方が設定されている場合、または IsRemovable プロパティが設定されている場合、そのプロバイダーをスマート カード プロバイダーとみなします。

キーを含むトークンを取り外せるかどうかを示すブール値を取得します。

オペレーター カードやスマート カードは、キーを含めることができる取り外し可能なトークンの例です。たとえば、次のプロバイダーはこのプロパティ値に true を返します。

• Microsoft Smart Card Key Storage Provider
• Microsoft Base Smart Card Crypto Provider

証明書登録サービスは、IsHardwareDevice プロパティと IsSoftwareDevice プロパティの両方が設定されている場合、または IsRemovable プロパティが設定されている場合、そのプロバイダーをスマート カード プロバイダーとみなします。

プロバイダーがソフトウェアに実装されているかどうかを示すブール値を取得します。

このプロパティは、プロバイダーがソフトウェアに実装されているかどうかのみを示します。プロバイダーはハードウェアとソフトウェアの両方に実装できるため、IsSoftwareDevice プロパティが true であってもハードウェア コンポーネントが存在しないとは限りません。IsHardwareDevice プロパティも確認する必要があります。次の Microsoft プロバイダーは IsSoftwareDevice プロパティに true を返します。

• Microsoft Software Key Storage Provider
• Microsoft Smart Card Key Storage Provider
• Microsoft Base Cryptographic Provider v1.0
• Microsoft Base DSS and Diffie-Hellman Cryptographic Provider
• Microsoft Base DSS Cryptographic Provider
• Microsoft Base Smart Card Crypto Provider
• Microsoft DH Schannel Cryptographic Provider
• Microsoft Enhanced Cryptographic Provider v1.0
• Microsoft Enhanced DSS and Diffie-Hellman Cryptographic Provider
• Microsoft Enhanced RSA and AES Cryptographic Provider
• Microsoft RSA Schannel Cryptographic Provider
• Microsoft Strong Cryptographic Provider

Microsoft Smart Card Key Storage Provider と Microsoft Base Smart Card Crypto Provider は、IsHardwareDevice プロパティにも true を返します。証明書登録サービスは、IsHardwareDevice プロパティと IsSoftwareDevice プロパティの両方が設定されている場合、または IsRemovable プロパティが設定されている場合、スマート カード プロバイダーとみなします。

プロバイダーがクライアント コンピューターにインストールされているかどうかを示すブール値を取得します。

Valid プロパティは通常、テンプレート ベースの証明書要求で指定されたプロバイダーの一覧を処理するときに、Certificate Enrollment Control によって設定されます。テンプレートに記載されているプロバイダーがクライアントにインストールされていない場合、コントロールは ICspInformation オブジェクトを作成し、このプロパティの値を false に設定します。このプロパティ値は、プロバイダーが利用可能かどうかを示すためにユーザー インターフェイスで使用できます。プロバイダーがインストールされていない場合、意味のある情報を提供するのは Valid プロパティと Name プロパティのみです。

プロバイダーに関連付けられた秘密キー コンテナーの名前でサポートされる最大の長さを取得します。

キー コンテナー名は、IX509PrivateKey インターフェイスの ContainerName プロパティを呼び出すことで指定および取得できます。Microsoft が配布するプロバイダーに関連付けられた値を次の表に示します。これらのプロバイダーの一部はすべてのオペレーティング システムに含まれているとは限らず、代わりに別のものが含まれている場合があります。

名前を取得します。

次の一覧は、Windows Vista 以降にインストールされる Microsoft プロバイダーの一部の名前を示しています。この一覧はすべてを網羅したものではありません。

• Microsoft Software Key Storage Provider
• Microsoft Smart Card Key Storage Provider
• Microsoft Base Cryptographic Provider v1.0
• Microsoft Base DSS and Diffie-Hellman Cryptographic Provider
• Microsoft Base DSS Cryptographic Provider
• Microsoft Base Smart Card Crypto Provider
• Microsoft DH Schannel Cryptographic Provider
• Microsoft Enhanced Cryptographic Provider v1.0
• Microsoft Enhanced DSS and Diffie-Hellman Cryptographic Provider
• Microsoft Enhanced RSA and AES Cryptographic Provider
• Microsoft RSA Schannel Cryptographic Provider
• Microsoft Strong Cryptographic Provider

プロバイダーの種類を取得します。

Microsoft が配布するプロバイダーに関連付けられた値を次の表に示します。これらのプロバイダーの一部はすべてのオペレーティング システムに含まれているとは限らず、代わりに別のものが含まれている場合があります。

プロバイダーのバージョン番号を取得します。

プロバイダーがサポートするアルゴリズムの用途を示す値を取得します。

取得される値は 0、1、2、または 3 です。値が 0 (XCN_AT_NONE) の場合、そのプロバイダーは Cryptography API: Next Generation (CNG) プロバイダーです。Microsoft が配布するプロバイダーに関連付けられた値を次の表に示します。これらのプロバイダーの一部はすべてのオペレーティング システムに含まれているとは限らず、代わりに別のものが含まれている場合があります。

プロバイダーがスマート カード プロバイダーかどうかを示すブール値を取得します。

スマート カード プロバイダーは通常、IsHardwareDevice プロパティと IsSoftwareDevice プロパティが設定されているか、IsRemovable プロパティが設定されていることで識別されます。

既定の秘密キー セキュリティ記述子を取得します。

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

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

セキュリティ記述子を使用するには、Microsoft Authorization API に含まれる ConvertStringSecurityDescriptorToSecurityDescriptor 関数を呼び出し、GetDefaultSecurityDescriptor メソッドが返した文字列を指定する必要があります。この関数は SECURITY_DESCRIPTOR 構造体へのポインターを返します。

既定のセキュリティ記述子は、コンピューターとユーザーの秘密キーへのアクセスを次のように定義するために使用されます。

• 既定では、ローカル管理者と LocalSystem アカウントで実行されているサービスのみが、コンピューター アカウントに関連付けられた秘密キーにアクセスできます。
• プロバイダーがユーザーの秘密キーをユーザー プロファイル内の暗号化されたファイルに格納する場合、セキュリティ記述子を使用してそのファイルへのアクセス許可を設定します。

このメソッドは、新しい秘密キーが作成される場合に、指定された MachineContext パラメーターと現在のプロバイダーに関連付けられる既定のセキュリティ記述子を取得します。既定の記述子を使用してカスタム記述子を作成できます。カスタム記述子は通常、コンピューター コンテキストの証明書に関連付けられた秘密キーを、LocalSystem アカウント以外のアカウントで実行されているサービスが使用する必要がある場合に作成されます。

一部の暗号化プロバイダーはセキュリティ記述子をサポートしていません。例として、スマート カード プロバイダーやハードウェア セキュリティ モジュール (HSM) プロバイダーが挙げられます。

プロバイダーが Cryptography API: Next Generation (CNG) プロバイダーか、CryptoAPI (レガシー) CSP かを示すブール値を取得します。

指定された署名、暗号化、ハッシュ、または暗号操作と一致する、最初にサポートされるアルゴリズムに対する ICspStatus オブジェクトを作成します。

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

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

ICspStatus オブジェクトには、暗号化プロバイダーに関するステータス情報が含まれます。各オブジェクトは、プロバイダーがサポートする特定のアルゴリズムに対して初期化されます。pAlgorithm パラメーターでアルゴリズムを指定しない場合、許可された操作と一致する最初にサポートされるアルゴリズムが選択され、ICspStatus オブジェクトが作成されます。