ICspStatus::get_EnrollmentStatus メソッド (certenroll.h)
EnrollmentStatus プロパティは、証明書の登録に関する情報を含む IX509EnrollmentStatus オブジェクトを取得します。
このプロパティは読み取り専用です。
構文
HRESULT get_EnrollmentStatus(
IX509EnrollmentStatus **ppValue
);
パラメーター
ppValue
戻り値
なし
解説
このプロパティは IX509EnrollmentStatus オブジェクトを 返します。 このオブジェクトは通常、PKCS #10 証明書要求を作成するときに設定されます。 このオブジェクトによって返される次の 3 つのプロパティは、 ICspStatus オブジェクトによって表されるプロバイダーとアルゴリズムのペアに関する情報を提供します。
- Display プロパティは、プロバイダーとアルゴリズムをユーザー インターフェイスに表示するかどうかを指定します。
- Selected プロパティは、プロバイダーとアルゴリズムを使用して証明書要求のキー ペアを作成できるかどうかを指定します。
- Status プロパティは、プロバイダーとアルゴリズムがスキップされたか、要求の初期化中にエラーが発生したかを指定します。
これらのプロパティがどのように重要であるかを理解するには、証明書要求が特定のプロバイダーとアルゴリズムを指定するテンプレートに基づいていると仮定します。 このプロバイダーとアルゴリズムのペアの Display プロパティと Status プロパティが有効になっています。 他の ICspStatus オブジェクトの場合、これらのプロパティの一方または両方が有効になっていない可能性があります。 詳細な例については、 序数 プロパティを参照してください。
IX509EnrollmentStatus オブジェクトが最初に作成されるときに、Status プロパティは EnrollUnknown に設定されます。 プロバイダーとアルゴリズムのペアが選択されていない場合は、状態が EnrollSkipped に設定されている可能性があります。 証明書の初期化中に選択したプロバイダーとアルゴリズムに対してキーの作成が失敗した場合、状態は EnrollError に設定されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | certenroll.h |
| [DLL] | CertEnroll.dll |