Função WTSStartRemoteControlSessionA (wtsapi32.h)

  • Artigo

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 tecla 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 HotkeyVk .

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

Retornar valor

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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista com SP1
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wtsapi32.h
Biblioteca Wtsapi32.lib
DLL Wtsapi32.dll