iCspStatus 接口 (certenroll.h)

ICspStatus 对象包含有关加密提供程序/算法对的信息。 该对象主要由证书注册控件使用,使用户能够选择在创建证书请求时要使用的加密提供程序和算法。 可以通过调用以下属性或方法单独或在 ICspStatuses 集合中检索它:

属性/方法 接口 说明
GetCspStatusFromOperations ICspInformation 为第一个受支持的算法创建 一个 ICspStatus 对象,该对象与 OID) 和算法类型 (指定的算法对象标识符一致。
GetCspStatusesFromOperations ICspInformations 为指定的算法类型和可选提供程序信息创建 ICspStatuses 集合。
注意 证书注册控制仅将 ICspStatuses 集合用于私钥非对称 (加密、签名和密钥交换) 算法选择。
 
GetCspStatusFromProviderName ICspInformations 按提供程序名称和支持的密钥操作为旧提供程序创建 ICspStatus 对象。
CspStatus IX509PrivateKey 指定或检索 ICspStatus 对象。 对象通常在注册过程中创建。
GetCspStatuses IX509CertificateRequestPkcs10 创建一个 ICspStatuses 集合,该集合包含与调用方指定的私钥的预期用途一致的所有提供程序/算法对。
CspStatuses IX509CertificateRequestPkcs10 创建一个 ICspStatuses 集合,其中包含与与证书请求关联的 IX509PrivateKey 对象所标识的私钥的预期用途一致的所有提供程序/算法对。
 

由于加密提供程序通常支持多种算法,因此在调用上述任何返回集合的属性或方法时,可能会创建并返回多个 ICspStatus 对象。 下图显示了这一点:

显示单个 ICspStatus 对象的 ICspStatuses 集合的结构

可以使用 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

指定或检索 ICspStatus 对象在 ICspStatuses 集合中的位置。 (获取)
ICspStatus::Initialize

从加密提供程序和关联的算法初始化 对象。
ICspStatus::p ut_Ordinal

指定或检索 ICspStatus 对象在 ICspStatuses 集合中的位置。 (放置)

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 certenroll.h

另请参阅

CertEnroll 接口

ICspStatuses

IDispatch