ICspStatus インターフェイス (certenroll.h)
ICspStatus オブジェクトには、暗号化プロバイダーとアルゴリズムのペアに関する情報が含まれています。 オブジェクトは、主に証明書登録コントロールによって使用され、証明書要求の作成時に使用する暗号化プロバイダーとアルゴリズムをユーザーが選択できるようにします。 これは、次のプロパティまたはメソッドを呼び出すことによって、単独または ICspStatuses コレクション内で取得できます。
| Property/Method | インターフェイス | 説明 |
|---|---|---|
| GetCspStatusFromOperations | ICspInformation | 指定されたアルゴリズム オブジェクト識別子 (OID) とアルゴリズムの種類と一致する、サポートされている最初のアルゴリズムの ICspStatus オブジェクトを作成します。 |
| GetCspStatusesFromOperations | ICspInformations | 指定したアルゴリズムの種類とオプションのプロバイダー情報の ICspStatuses コレクションを作成します。 メモ 証明書登録コントロールでは、秘密キー非対称 (暗号化、署名、およびキー交換) アルゴリズムの選択にのみ ICspStatuses コレクションが使用されます。
|
| GetCspStatusFromProviderName | ICspInformations | プロバイダー名とサポートされているキー操作によって、レガシ プロバイダーの ICspStatus オブジェクトを作成します。 |
| CspStatus | IX509PrivateKey | ICspStatus オブジェクトを指定または取得します。 オブジェクトは通常、登録プロセス中に作成されます。 |
| GetCspStatuses | IX509CertificateRequestPkcs10 | 呼び出し元によって指定された秘密キーの使用目的と一致するすべてのプロバイダーとアルゴリズムのペアを含む ICspStatuses コレクションを作成します。 |
| CspStatuses | IX509CertificateRequestPkcs10 | 証明書要求に関連付けられている IX509PrivateKey オブジェクトによって識別される秘密キーの使用に一致するすべてのプロバイダーとアルゴリズムのペアを含む ICspStatuses コレクションを作成します。 |
暗号化プロバイダーは通常、複数のアルゴリズムをサポートするため、コレクションを返す上記のプロパティまたはメソッドのいずれかを呼び出すと、複数の ICspStatus オブジェクトが作成され、返される場合があります。 これを次の図に示します。
ICspStatus オブジェクトの EnrollmentStatus プロパティを使用すると、次のプロパティを定義する IX509EnrollmentStatus オブジェクトを取得できます。
- Display プロパティは、プロバイダーとアルゴリズムのペアをユーザー インターフェイスに表示できるかどうかを指定します。
- Selected プロパティは、登録プロセス中に特定のアイテムの状態を監視するかどうかを示す値を指定または取得します。
- Status プロパティは、登録プロセスの状態を識別します。
継承
ICspStatus インターフェイスは、IDispatch インターフェイスから継承されます。 ICspStatus には、次の種類のメンバーもあります。
メソッド
ICspStatus インターフェイスには、これらのメソッドがあります。
| ICspStatus::get_CspAlgorithm プロバイダーでサポートされているアルゴリズムに関する情報を含む ICspAlgorithm オブジェクトを取得します。 |
| ICspStatus::get_CspInformation プロバイダーに関する一般的な情報を含む ICspInformation オブジェクトを取得します。 |
| ICspStatus::get_DisplayName プロバイダーの名前、アルゴリズム名、およびアルゴリズムによって実行できる操作を含む文字列を取得します。 |
| ICspStatus::get_EnrollmentStatus 証明書の登録に関する情報を含む IX509EnrollmentStatus オブジェクトを取得します。 |
| ICspStatus::get_Ordinal ICspStatuses コレクション内の ICspStatus オブジェクトの位置を指定または取得します。 (Get) |
| ICspStatus::Initialize 暗号化プロバイダーと関連付けられたアルゴリズムから オブジェクトを初期化します。 |
| ICspStatus::p ut_Ordinal ICspStatuses コレクション内の ICspStatus オブジェクトの位置を指定または取得します。 (Put) |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | certenroll.h |