Метод IPart::GetName (devicetopology.h)

Метод GetName получает понятное имя этой части.

Синтаксис

HRESULT GetName(
  [out] LPWSTR *ppwstrName
);

Параметры

[out] ppwstrName

Указатель на переменную указателя, в которую метод записывает адрес строки расширенных символов, завершающейся null, которая содержит понятное имя этой части. Метод выделяет хранилище для строки. Вызывающий объект отвечает за освобождение хранилища, когда оно больше не требуется, путем вызова функции CoTaskMemFree . Если вызов GetName завершается ошибкой, *ppwstrName имеет значение NULL. Сведения о CoTaskMemFree см. в документации по Windows SDK.

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

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

Код возврата	Описание
E_POINTER	Указатель ppwstrName имеет значение NULL.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	devicetopology.h

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

Интерфейс IPart