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

Метод IWMDeviceManager2::GetDeviceFromCanonicalName (mswmdm.h)

  • Статья

Метод GetDeviceFromCanonicalName извлекает интерфейс IWMDMDevice для устройства с указанным каноническим именем. Каноническое имя устройства можно получить, вызвав IWMDMDevice2::GetCanonicalName.

Синтаксис

HRESULT GetDeviceFromCanonicalName(
  LPCWSTR     pwszCanonicalName,
  IWMDMDevice **ppDevice
);

Параметры

pwszCanonicalName

Строка с расширенными символами, заканчивающаяся null, указывающая каноническое имя устройства.

ppDevice

Указатель на указатель на интерфейс IWMDMDevice объекта устройства с указанным каноническим именем. Вызывающий объект должен освободить этот интерфейс по завершении работы с ним.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
E_INVALIDARG
 Параметр pwszCanonicalName или ppDeviceArray является недопустимым или пустым указателем.
S_FALSE
 Не найдено подключенного устройства с каноническим именем pwszCanonicalName.

Комментарии

Этот метод может быть полезен, если приложение реализует IWMDMNotification, которое отправляет каноническое уведомление об имени, когда устройство подключается или отключается от компьютера.

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

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

Интерфейс IWMDMDevice2

Интерфейс IWMDeviceManager2