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 をアプリケーションが実装する場合に役立ちます。