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


Метод ICEnroll4::enumPendingRequest (xenroll.h)

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

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

Этот метод был впервые определен в интерфейсе ICEnroll4 .

Синтаксис

HRESULT enumPendingRequest(
  [in]  LONG    lIndex,
  [in]  LONG    lDesiredProperty,
  [out] VARIANT *pvarProperty
);

Параметры

[in] lIndex

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

[in] lDesiredProperty

Идентификатор извлекаемого свойства. Этот параметр может принимать одно из указанных ниже значений.

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

[out] pvarProperty

Указатель на VARIANT , который получает значение полученного свойства.

Завершив использование variant, освободите его, вызвав функцию VariantClear .

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

C++

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

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

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

  • XEPR_DATE
  • XEPR_V1TEMPLATENAME
  • XEPR_V2TEMPLATEOID
  • XEPR_VERSION

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

VB

Возвращает объект Variant , содержащий свойство из ожидающего запроса.

Комментарии

Этот метод отключается, когда элемент управления регистрацией сертификатов выполняется как элемент управления на основе скриптов.

Требования

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