Метод IEnumCERTVIEWATTRIBUTE::GetName (certview.h)
Метод GetName извлекает имя текущего атрибута в последовательности перечисления атрибутов.
Синтаксис
HRESULT GetName(
[out] BSTR *pstrOut
);
Параметры
[out] pstrOut
Указатель на переменную типа BSTR , содержащую имя атрибута.
Возвращаемое значение
C++
Если метод выполнен успешно, метод возвращает S_OK, а параметр pstrOut содержит имя атрибута.Чтобы использовать этот метод, создайте переменную типа BSTR , задайте для переменной значение NULL и передайте адрес этой переменной как pstrOut. Завершив использование BSTR, освободите его, вызвав функцию SysFreeString .
Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
VB
Возвращаемое значение — это строка , содержащая имя атрибута.Комментарии
Этот метод используется для получения имени атрибута, на который в данный момент ссылается последовательность перечисления атрибутов.
Если последовательность перечисления атрибутов не ссылается на допустимый атрибут, getName завершится ошибкой. Используйте один из следующих методов для перехода по перечислению:
- IEnumCERTVIEWATTRIBUTE::Reset: перемещается в начало последовательности перечисления.
- IEnumCERTVIEWATTRIBUTE::Next: перемещается к следующему атрибуту в последовательности перечисления.
- IEnumCERTVIEWATTRIBUTE::Skip: пропускает указанное количество атрибутов.
Примеры
BSTR bstrAttribName = NULL;
// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetName(&bstrAttribName);
if (S_OK != hr)
printf("Failed call to GetName - %x\n", hr);
else
printf("Attribute name is %ws\n", bstrAttribName );
// free memory when done
if (NULL != bstrAttribName)
SysFreeString(bstrAttribName);
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | certview.h (включая Certsrv.h) |
| Библиотека | Certidl.lib |
| DLL | Certadm.dll |