Интерфейс 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 . Это показано на следующем рисунке:

Структура коллекции ICspStatuses с отдельными объектами ICspStatus

Свойство EnrollmentStatus можно использовать для объекта ICspStatus , чтобы получить объект 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. (Put)

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header certenroll.h

См. также раздел

Интерфейсы CertEnroll

ICspStatuses

IDispatch