Método IMsRdpClientNonScriptable::NotifyRedirectDeviceChange
Notifica o módulo de redirecionamento de dispositivo do controle ActiveX da Área de Trabalho Remota de que ocorreu uma alteração de dispositivo no sistema. Esse método passa WM_DEVICECHANGE notificações para o controle.
Sintaxe
HRESULT NotifyRedirectDeviceChange(
[in] WPARAM wParam,
[in] LPARAM lParam
);
Parâmetros
-
wParam [in]
-
Especifica o evento do dispositivo. Esse parâmetro pode usar um dos valores a seguir.
-
DBT_CONFIGCHANGECANCELED
-
Uma solicitação para alterar a configuração atual (encaixe ou desencaixe) foi cancelada.
-
DBT_CONFIGCHANGED
-
A configuração atual foi alterada devido a um encaixe ou desencaixe.
-
DBT_CUSTOMEVENT
-
Ocorreu um evento personalizado.
-
DBT_DEVICEARRIVAL
-
Um dispositivo foi inserido e agora está disponível.
-
DBT_DEVICEQUERYREMOVE
-
A permissão é solicitada para remover um dispositivo. Qualquer aplicativo pode negar essa solicitação e cancelar a remoção.
-
DBT_DEVICEQUERYREMOVEFAILED
-
Uma solicitação para remover um dispositivo foi cancelada.
-
DBT_DEVICEREMOVECOMPLETE
-
Um dispositivo foi removido.
-
DBT_DEVICEREMOVEPENDING
-
Um dispositivo está prestes a ser removido. A remoção não pode ser negada.
-
DBT_DEVICETYPESPECIFIC
-
Ocorreu um evento específico do dispositivo.
-
DBT_DEVNODES_CHANGED
-
Um dispositivo foi adicionado ou removido do sistema.
-
DBT_QUERYCHANGECONFIG
-
A permissão é solicitada para alterar a configuração atual (encaixar ou desencaixar).
-
DBT_USERDEFINED
-
O significado dessa mensagem é definido pelo usuário.
lParam [in]
Ponteiro para uma estrutura que contém dados específicos do evento. Seu formato depende do valor do parâmetro wParam . Para obter mais informações, consulte a documentação de cada evento. Para obter mais informações, consulte Tipos de evento de dispositivo.
Valor retornado
Retorne S_OK se tiver êxito.
Comentários
Um aplicativo de contêiner que permite a adição ou remoção dinâmica de dispositivos deve processar a mensagem WM_DEVICECHANGE em sua janela de nível superior e encaminhar a mensagem para o controle usando o método NotifyRedirectDeviceChange . Um exemplo de alteração dinâmica do dispositivo é quando uma unidade de disco redirecionada é adicionada ou removida enquanto o sistema está em execução.
Para obter mais informações sobre a Conexão da Web da Área de Trabalho Remota, consulte Requisitos para conexão da Web da Área de Trabalho Remota.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Biblioteca de tipos |
|
| DLL |
|
| IID |
IID_IMsRdpClientNonScriptable é definido como 2f079c4c-87b2-4afd-97ab-20cdb43038ae |