Méthode IPortableDeviceManager ::RefreshDeviceList (portabledeviceapi.h)
La méthode RefreshDeviceList actualise la liste des appareils connectés à l’ordinateur.
Syntaxe
HRESULT RefreshDeviceList();
Valeur de retour
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
Remarques
Lorsque l’interface IPortableDeviceManager est instanciée la première fois, elle génère une liste des appareils connectés. Toutefois, les appareils peuvent se connecter et se déconnecter de l’ordinateur, ce qui rend la liste d’origine obsolète. Cette méthode permet à une application d’actualiser la liste des appareils connectés.
Cette méthode nécessite moins de ressources que l’instanciation d’un nouveau gestionnaire d’appareils pour générer une nouvelle liste d’appareils. Toutefois, il nécessite certaines ressources ; par conséquent, nous vous recommandons de ne pas appeler cette méthode arbitrairement. La meilleure solution consiste à faire inscrire l’application pour obtenir les notifications d’arrivée et de suppression de l’appareil, et quand une notification est reçue, faites en sorte que l’application appelle cette fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | portabledeviceapi.h |
| Bibliothèque | PortableDeviceGUIDs.lib |