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

Статья
08/25/2023

Метод 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

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