IPortableDevice::GetPnPDeviceID メソッド (portabledeviceapi.h)

GetPnPDeviceID メソッドは、アプリケーションがデバイスを開くために使用したプラグ アンド プレイ (PnP) デバイス識別子を取得します。

構文

HRESULT GetPnPDeviceID(
  [out] LPWSTR *ppszPnPDeviceID
);

パラメーター

[out] ppszPnPDeviceID

デバイスのプラグ アンド プレイ ID 文字列を含む null で終わる文字列へのポインター。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
メソッドが成功しました。
E_WPD_DEVICE_NOT_OPEN
このデバイスに対して IPortableDevice::Open メソッドがまだ呼び出されていません。

解説

このメソッドによって返される文字列を使用してアプリケーションが終了したら、 CoTaskMemFree 関数を呼び出して文字列を解放する必要があります。

ppszPnPDeviceID 引数を NULL に設定することはできません。

必要条件

   
対象プラットフォーム Windows
ヘッダー portabledeviceapi.h
Library PortableDeviceGUIDs.lib

関連項目

IPortableDevice インターフェイス

IPortableDevice::Open