Метод IEnumCERTVIEWATTRIBUTE::Next (certview.h)
Метод Next переходит к следующему атрибуту в последовательности перечисления атрибутов.
Синтаксис
HRESULT Next(
[out] LONG *pIndex
);
Параметры
[out] pIndex
Указатель на переменную, содержащую значение индекса следующего атрибута , на который ссылается ссылка. Если атрибутов для перечисления больше нет, для этой переменной устанавливается значение –1. Этот метод завершается ошибкой, если pIndex имеет значение NULL.
Возвращаемое значение
C++
Если метод завершается успешно, метод возвращает S_OK и на следующий атрибут теперь ссылается последовательность перечисления атрибутов. Если атрибутов больше нет, метод возвращает S_FALSE, а pIndex имеет значение –1.Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
VB
Возвращаемое значение — это значение индекса атрибута, на который теперь ссылается последовательность перечисления атрибутов. Если атрибутов для перечисления больше нет, возвращается значение –1.Комментарии
После успешного завершения этого метода доступ к имени и значению атрибута можно получить с помощью следующих методов:
Примеры
LONG Index;
HRESULT hr;
BSTR bstrAttribName = NULL;
// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
while (S_OK == pEnumAttr->Next(&Index))
{
// retrieve the attribute name
hr = pEnumAttr->GetName(&bstrAttribName);
if (FAILED(hr))
printf("Failed GetName - %x\n", hr );
else
printf("Attribute name: %ws\n", bstrAttribName);
}
// Free resources.
if (NULL != bstrAttribName)
SysFreeString(bstrAttribName);
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | certview.h (включая Certsrv.h) |
| Библиотека | Certidl.lib |
| DLL | Certadm.dll |
См. также раздел
IEnumCERTVIEWATTRIBUTE::GetName