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