Метод IEnroll4::enumPendingRequestWStr (xenroll.h)

Статья
03/13/2024

[Этот метод больше недоступен для использования в Windows Server 2008 и Windows Vista.]

Метод enumPendingRequestWStr перечисляет ожидающие запросы сертификата и извлекает указанное свойство из каждого из них. Этот метод был впервые определен в интерфейсе IEnroll4 .

Синтаксис

HRESULT enumPendingRequestWStr(
  [in]  LONG   lIndex,
  [in]  LONG   lDesiredProperty,
  [out] LPVOID ppProperty
);

Параметры

[in] lIndex

Указывает порядковый номер ожидающего запроса, свойство которого будет извлечено. Укажите ноль для первого запроса.

[in] lDesiredProperty

Идентификатор извлекаемого свойства. Укажите одно из следующих значений.

Значение	Значение
XEPR_CADNS	DNS-имя центра сертификации (ЦС).
XEPR_CAFRIENDLYNAME	Отображаемое имя ЦС.
XEPR_CANAME	Имя ЦС.
XEPR_HASH	Хэш-значение запроса.
XEPR_REQUESTID	Идентификатор запроса сертификата.

[out] ppProperty

Указатель на VOID , получающий значение полученного свойства.

Возвращаемое значение

Если метод выполнен успешно, метод возвращает S_OK.

Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Если для lDesiredProperty указаны следующие значения, этот метод возвращает E_NOTIMPL:

XEPR_DATE
XEPR_V1TEMPLATENAME
XEPR_V2TEMPLATEOID
XEPR_VERSION

Если указать любое другое значение для lDesiredProperty, этот метод возвращает E_INVALIDARG.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	xenroll.h
Библиотека	Uuid.lib
DLL	Xenroll.dll

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

IEnroll4

Поделиться через