Метод ICspStatus::get_EnrollmentStatus (certenroll.h)
Свойство EnrollmentStatus извлекает объект IX509EnrollmentStatus , содержащий сведения о регистрации сертификата.
Это свойство доступно только для чтения.
Синтаксис
HRESULT get_EnrollmentStatus(
IX509EnrollmentStatus **ppValue
);
Параметры
ppValue
Возвращаемое значение
None
Remarks
Это свойство возвращает объект IX509EnrollmentStatus . Этот объект обычно заполняется при создании запроса сертификата PKCS #10. Следующие три свойства, возвращаемые этим объектом, предоставляют сведения о паре "поставщик-алгоритм", представленной объектом ICspStatus :
- Свойство Display указывает, должны ли поставщик и алгоритм отображаться в пользовательском интерфейсе.
- Свойство Selected указывает, можно ли использовать поставщик и алгоритм для создания пары ключей для запроса сертификата.
- Свойство Status указывает, были ли пропущены поставщик и алгоритм или произошла ошибка во время инициализации запроса.
Чтобы понять, насколько важны эти свойства, предположим, что запрос сертификата основан на шаблоне, который указывает конкретный поставщик и алгоритм. Свойства Display и Status для этой пары поставщик/алгоритм включены. Для других объектов ICspStatus одно или оба этих свойства могут быть не включены. Более полные примеры см. в свойстве Ordinal .
Свойство Status имеет значение EnrollUnknown при первом создании объекта IX509EnrollmentStatus . Если пара поставщик/алгоритм не выбрана, можно задать состояние EnrollSkipped. Состояние будет иметь значение EnrollError , если во время инициализации сертификата не удается создать ключ для выбранного поставщика и алгоритма.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | certenroll.h |
| DLL | CertEnroll.dll |