IPortableDeviceManager::RefreshDeviceList-Methode (portabledeviceapi.h)
Die RefreshDeviceList-Methode aktualisiert die Liste der Geräte, die mit dem Computer verbunden sind.
Syntax
HRESULT RefreshDeviceList();
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
Hinweise
Wenn die IPortableDeviceManager-Schnittstelle zum ersten Mal instanziiert wird, generiert sie eine Liste der verbundenen Geräte. Geräte können jedoch eine Verbindung mit dem Computer herstellen und trennen, sodass die ursprüngliche Liste veraltet ist. Mit dieser Methode kann eine Anwendung die Liste der verbundenen Geräte aktualisieren.
Diese Methode ist weniger ressourcenintensiv als das Instanziieren eines neuen Geräte-Managers, um eine neue Geräteliste zu generieren. Es sind jedoch einige Ressourcen erforderlich; Daher wird empfohlen, diese Methode nicht willkürlich aufzurufen. Die beste Lösung besteht darin, die Anwendung registrieren zu lassen, um Benachrichtigungen zur Geräteankunft und -entfernung zu erhalten, und wenn eine Benachrichtigung empfangen wird, lassen Sie die Anwendung diese Funktion aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | portabledeviceapi.h |
| Bibliothek | PortableDeviceGUIDs.lib |