Função WTSStartRemoteControlSessionA (wtsapi32.h)
Inicia o controle remoto de outra sessão dos Serviços de Área de Trabalho Remota. Você deve chamar essa função de uma sessão remota.
Sintaxe
BOOL WTSStartRemoteControlSessionA(
[in] LPSTR pTargetServerName,
[in] ULONG TargetLogonId,
[in] BYTE HotkeyVk,
[in] USHORT HotkeyModifiers
);
Parâmetros
[in] pTargetServerName
Um ponteiro para o nome do servidor em que a sessão da qual você deseja ter controle remoto existe.
[in] TargetLogonId
A ID de logon da sessão da qual você deseja controlar remotamente.
[in] HotkeyVk
O código de chave virtual que representa a tecla a ser pressionada para interromper o controle remoto da sessão. A chave definida nesse parâmetro é usada com o parâmetro HotkeyModifiers.
[in] HotkeyModifiers
O modificador virtual que representa a tecla a ser pressionada para interromper o controle remoto da sessão. O modificador virtual é usado com o parâmetro
Por exemplo, se a função WTSStartRemoteControlSession for chamada com HotkeyVk definido como VK_MULTIPLY e HotkeyModifiers definido como REMOTECONTROL_KBDCTRL_HOTKEY, o usuário que tem controle remoto da sessão de destino poderá pressionar CTRL + * para interromper o controle remoto da sessão e retornar à sua própria sessão.
REMOTECONTROL_KBDSHIFT_HOTKEY
A tecla SHIFT
REMOTECONTROL_KBDCTRL_HOTKEY
A tecla CTRL
REMOTECONTROL_KBDALT_HOTKEY
A chave ALT
Valor de retorno
Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
Nota
O cabeçalho wtsapi32.h define WTSStartRemoteControlSession como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows Vista com SP1 |
servidor com suporte mínimo | Windows Server 2008 |
da Plataforma de Destino |
Windows |
cabeçalho | wtsapi32.h |
biblioteca | Wtsapi32.lib |
de DLL |
Wtsapi32.dll |