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

O método RefreshDeviceList atualiza a lista de dispositivos conectados ao computador.

Sintaxe

HRESULT RefreshDeviceList();

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Quando a interface IPortableDeviceManager é instanciada pela primeira vez, ela gera uma lista dos dispositivos conectados. No entanto, os dispositivos podem se conectar e desconectar do computador, tornando a lista original obsoleta. Esse método permite que um aplicativo atualize a lista de dispositivos conectados.

Esse método é menos intensivo em recursos do que criar uma instância de um novo gerenciador de dispositivos para gerar uma nova lista de dispositivos. No entanto, isso requer alguns recursos; portanto, recomendamos que você não chame esse método arbitrariamente. A melhor solução é fazer com que o aplicativo se registre para obter notificações de chegada e remoção do dispositivo e, quando uma notificação for recebida, faça com que o aplicativo chame essa função.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceManager Interface