Compartilhar via


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

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