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