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