IWMDeviceManager2：：GetDeviceFromCanonicalName 方法 (mswmdm.h)

GetDeviceFromCanonicalName 方法检索具有指定规范名称的设备 IWMDMDevice 接口。可以通过调用 IWMDMDevice2：：GetCanonicalName 来检索设备的规范名称。

语法

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

pwszCanonicalName

一个以 null 结尾的宽字符字符串，用于指定设备的规范名称。

ppDevice

指向具有指定规范名称的设备对象的 IWMDMDevice 接口的指针的指针。调用方在使用完此接口时必须释放它。

该方法返回 HRESULT。可能的值包括（但并不限于）下表中的项。

返回代码	说明
E_INVALIDARG	pwszCanonicalName 或 ppDeviceArray 参数是无效的或 NULL 指针。
S_FALSE	找不到具有规范名称 pwszCanonicalName 的连接设备。

如果应用程序实现 IWMDMNotification，当设备连接或断开计算机连接时，此方法会发送规范名称通知，则此方法非常有用。