IPortableDeviceManager::RefreshDeviceList メソッド (portabledeviceapi.h)
RefreshDeviceList メソッドは、コンピューターに接続されているデバイスの一覧を更新します。
構文
HRESULT RefreshDeviceList();
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
注釈
IPortableDeviceManager インターフェイスが初めてインスタンス化されると、接続されているデバイスの一覧が生成されます。 ただし、デバイスはコンピューターに接続して切断できるため、元のリストは古くなっています。 このメソッドを使用すると、アプリケーションで接続されているデバイスの一覧を更新できます。
このメソッドは、新しいデバイス リストを生成するために新しいデバイス マネージャーをインスタンス化するよりも、リソースを消費する負荷が低くなります。 ただし、いくつかのリソースが必要です。そのため、このメソッドを任意に呼び出さないでください。 最善の解決策は、デバイスの到着と削除の通知を取得するためにアプリケーションを登録し、通知を受信したときに、アプリケーションでこの関数を呼び出すようにすることです。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |