Метод IEnumCERTVIEWEXTENSION::GetName (certview.h)

Статья
08/22/2023

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

Возвращаемое имя расширения представляет собой строку идентификатора объекта (OID), как в L"2.5.29.31".

Синтаксис

HRESULT GetName(
  [out] BSTR *pstrOut
);

Параметры

[out] pstrOut

Указатель на значение типа BSTR , содержащее имя расширения.

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

C++

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

Чтобы использовать этот метод, создайте переменную типа BSTR , задайте для переменной значение NULL и передайте адрес этой переменной как pstrOut. Завершив использование BSTR, освободите его, вызвав функцию SysFreeString .

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

VB

Возвращаемое значение — строка , содержащая имя расширения.

Если последовательность перечисления расширений не ссылается на допустимое расширение, getName завершится ошибкой. Используйте один из следующих методов для перехода по перечислению:

IEnumCERTVIEWEXTENSION::Reset: переходит к следующему расширению в последовательности перечисления.
IEnumCERTVIEWEXTENSION::Next: переходит к следующему расширению в последовательности перечисления.
IEnumCERTVIEWEXTENSION::Skip: пропускает указанное количество расширений.

Примеры

BSTR  bstrExtName = NULL;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->GetName(&bstrExtName);
if (S_OK == hr)
    printf("Extension name is: %ws\n", bstrExtName);
else
    printf("GetName failed: %x\n", hr);

// free memory when done
if (NULL != bstrExtName)
    SysFreeString(bstrExtName);

Требования

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