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