Поделиться через


Метод IWiaDrvItem::GetItemName (wiamindr_lh.h)

Метод IWiaDrvItem::GetItemName получает текущее имя элемента IWiaDrvItem , не включая сведения о пути.

Синтаксис

HRESULT GetItemName(
  BSTR *__MIDL__IWiaDrvItem0003
);

Параметры

__MIDL__IWiaDrvItem0003

pbstrItemName [out, optional]

Указывает на расположение памяти, которое получит адрес строки, содержащей имя элемента.

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

Если метод выполняется успешно, он сохраняет указатель на имя элемента (сведения о пути не включаются) в pbstrItemName и возвращает S_OK. Если методу не удается выделить строку из-за нехватки памяти, он возвращает E_OUTOFMEMORY. Если параметр pbstrItemName недопустим , метод возвращает E_INVALIDARG. Если метод завершается сбоем по другой причине, он возвращает стандартный код ошибки COM.

Комментарии

Если доступно достаточно памяти, метод выделяет строку, содержащую имя текущего элемента, за исключением сведений о пути. Метод возвращает указатель на строку в pbstrItemName. Мини-диск должен освободить память, используемую строкой, вызвав функцию SysFreeString .

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть wiamindr_lh.h (включая Wiamindr.h)

См. также раздел

IWiaDrvItem

IWiaDrvItem::GetFullItemName