Метод IWiaDrvItem::GetFullItemName (wiamindr_lh.h)
Метод IWiaDrvItem::GetFullItemName получает полное имя элемента, включая сведения о пути.
Синтаксис
HRESULT GetFullItemName(
BSTR *__MIDL__IWiaDrvItem0002
);
Параметры
__MIDL__IWiaDrvItem0002
pbstrFullItemName [out, optional]
Указывает на расположение памяти, которое получит адрес строки, содержащей полное имя элемента.
Возвращаемое значение
Если метод завершается успешно, он сохраняет указатель на полное имя элемента, включая сведения о пути, в pbstrFullItemName и возвращает S_OK. Если методу не удается выделить строку из-за нехватки памяти, он возвращает E_OUTOFMEMORY. Если параметр pbstrFullItemName недопустим , метод возвращает E_INVALIDARG. Если метод завершается сбоем по другой причине, он возвращает стандартный код ошибки COM.
Комментарии
Если доступно достаточно памяти, этот метод выделяет строку, содержащую полное имя текущего элемента, включая сведения о пути. Метод возвращает указатель на строку в pbstrFullItemName. Мини-диск должен освободить память, используемую строкой, вызвав функцию SysFreeString .
Имя, возвращаемое в pbstrFullItemName , — это имя, связанное с элементом, когда элемент был впервые создан функцией библиотеки служб драйверов wiasCreateDrvItem.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wiamindr_lh.h (включая Wiamindr.h) |