IWMDeviceManager2：：GetDeviceFromCanonicalName 方法 (mswmdm.h)

GetDeviceFromCanonicalName 方法會擷取具有指定標準名稱之裝置的 IWMDMDevice 介面。您可以呼叫 IWMDMDevice2：：GetCanonicalName 來擷取裝置的正式名稱。

語法

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

pwszCanonicalName

寬字元 、以 Null 結尾的字串，指定裝置標準名稱。

ppDevice

指向具有指定標準名稱之裝置物件的 IWMDMDevice 介面指標。呼叫端必須在完成此介面時釋放此介面。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	Description
E_INVALIDARG	pwszCanonicalName 或 ppDeviceArray 參數是無效或 NULL 指標。
S_FALSE	找不到標準名稱 pwszCanonicalName 的連線裝置。

如果應用程式實作 IWMDMNotification，當裝置與電腦連線或中斷連線時，這個方法會傳送標準名稱通知。