Método IPortableDeviceManager::RefreshDeviceList (portabledeviceapi.h)

  • Artículo

El método RefreshDeviceList actualiza la lista de dispositivos conectados al equipo.

Sintaxis

HRESULT RefreshDeviceList();

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.

Comentarios

Cuando se crea una instancia de la interfaz IPortableDeviceManager la primera vez, genera una lista de los dispositivos conectados. Sin embargo, los dispositivos pueden conectarse y desconectarse del equipo, lo que hace que la lista original sea obsoleta. Este método permite a una aplicación actualizar la lista de dispositivos conectados.

Este método consume menos recursos que crear instancias de un nuevo administrador de dispositivos para generar una nueva lista de dispositivos. Sin embargo, requiere algunos recursos; por lo tanto, se recomienda no llamar a este método arbitrariamente. La mejor solución es hacer que la aplicación se registre para obtener las notificaciones de llegada y eliminación del dispositivo y, cuando se reciba una notificación, haga que la aplicación llame a esta función.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado portabledeviceapi.h
Library PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceManager (interfaz)