Partager via


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
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

Voir aussi

IPortableDeviceManager, interface