Метод IEnumCERTVIEWCOLUMN::GetDisplayName (certview.h)

Статья
08/22/2023

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

Синтаксис

HRESULT GetDisplayName(
  [out] BSTR *pstrOut
);

Параметры

[out] pstrOut

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

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

C++

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

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

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

VB

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

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

IEnumCERTVIEWCOLUMN::Reset: перемещается в начало последовательности перечисления.
IEnumCERTVIEWCOLUMN::Next: перемещается к следующему столбцу в последовательности перечисления.
IEnumCERTVIEWCOLUMN::Skip: пропускает указанное количество столбцов.

Примеры

BSTR     bstrDisplay = NULL;
HRESULT  hr;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object.
hr = pEnumCol->GetDisplayName(&bstrDisplay);
if (S_OK == hr)
    printf("Column name is %ws\n", bstrDisplay);

// Done processing, clear resources.
if (NULL != bstrDisplay)
    SysFreeString(bstrDisplay);

Требования


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