Método IMsRdpClientNonScriptable::NotifyRedirectDeviceChange

  • Artigo

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
MsTscAx.dll
DLL
MsTscAx.dll
IID
 IID_IMsRdpClientNonScriptable é definido como 2f079c4c-87b2-4afd-97ab-20cdb43038ae

Confira também

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsRdpClientNonScriptable