Метод IEnumCERTVIEWCOLUMN::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 завершится ошибкой. Используйте один из следующих методов для перехода по перечислению:
- IEnumCERTVIEWCOLUMN::Reset: перемещается в начало последовательности перечисления.
- IEnumCERTVIEWCOLUMN::Next: перемещается к следующему столбцу в последовательности перечисления.
- IEnumCERTVIEWCOLUMN::Skip: пропускает указанное количество столбцов.
Примеры
BSTR bstrColName = NULL;
HRESULT hr;
// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetName(&bstrColName);
if (S_OK == hr)
printf("Column name is %ws\n", bstrColName);
// done processing, clear resources
if (NULL != bstrColName)
SysFreeString(bstrColName);
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | certview.h (включая Certsrv.h) |
| Библиотека | Certidl.lib |
| DLL | Certadm.dll |