Função WTSConnectSessionA (wtsapi32.h)

Artigo
11/20/2024

Conecta uma sessão dos Serviços de Área de Trabalho Remota a uma sessão existente no computador local.

Sintaxe

BOOL WTSConnectSessionA(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PSTR  pPassword,
  [in] BOOL  bWait
);

Parâmetros

[in] LogonId

A ID de logon da sessão à qual se conectar. O usuário dessa sessão deve ter permissões para se conectar a uma sessão existente. A saída desta sessão será roteada para a sessão identificada pelo parâmetro TargetLogonId.

Isso pode ser LOGONID_CURRENT para usar a sessão atual.

[in] TargetLogonId

A ID de logon da sessão para receber a saída da sessão representada pelo parâmetro LogonId. A saída da sessão identificada pelo parâmetro LogonId será roteada para esta sessão.

Isso pode ser LOGONID_CURRENT para usar a sessão atual.

[in] pPassword

Um ponteiro para a senha da conta de usuário especificada no parâmetro logonId . O valor de pPassword pode ser uma cadeia de caracteres vazia se o chamador estiver conectado usando o mesmo nome de domínio e nome de usuário que a ID de logon. O valor de pPassword não pode ser NULL.

[in] bWait

Indica se a operação é síncrona. Especifique TRUE aguarde a conclusão da operação ou FALSE retorne imediatamente.

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

O parâmetro LogonId ou TargetLogonId pode ser LOGONID_CURRENT, mas não ambos.

Nota

O cabeçalho wtsapi32.h define WTSConnectSession 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

Compartilhar via