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


Метод ICertServerPolicy::EnumerateAttributes (certif.h)

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

Синтаксис

HRESULT EnumerateAttributes(
  [out] BSTR *pstrAttributeName
);

Параметры

[out] pstrAttributeName

Указатель на имя атрибута.

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

C++

Если метод выполнен успешно, метод возвращает S_OK, а параметру pstrAttributeName присваивается значение BSTR , содержащее имя атрибута. Если последний атрибут уже был перечислен, возвращается значение S_FALSE.

Чтобы использовать этот метод, создайте переменную типа BSTR , задайте для переменной значение NULL, а затем передайте адрес этой переменной как pstrAttributeName.

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

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

VB

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

Комментарии

Перед первым вызовом метода EnumerateAttributes вызовите метод EnumerateAttributesSetup , чтобы инициализировать указатель перечисления на первый атрибут.

Завершив перечисление, вызовите
Метод EnumerateAttributesClose для освобождения ресурсов, используемых в вызовах перечисления.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header certif.h (включая Certsrv.h)
Библиотека Certidl.lib
DLL Certcli.dll

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

ICertServerPolicy

ICertServerPolicy::EnumerateAttributesClose

ICertServerPolicy::EnumerateAttributesSetup