Função WTSSendMessageA (wtsapi32.h)

Exibe uma caixa de mensagem na área de trabalho do cliente de uma sessão especificada dos Serviços de Área de Trabalho Remota.

Sintaxe

BOOL WTSSendMessageA(
  [in]  HANDLE hServer,
  [in]  DWORD  SessionId,
  [in]  LPSTR  pTitle,
  [in]  DWORD  TitleLength,
  [in]  LPSTR  pMessage,
  [in]  DWORD  MessageLength,
  [in]  DWORD  Style,
  [in]  DWORD  Timeout,
  [out] DWORD  *pResponse,
  [in]  BOOL   bWait
);

Parâmetros

[in] hServer

Um identificador para um servidor Host da Sessão de Área de Trabalho Remota. Especifique um identificador aberto pela função WTSOpenServer ou especifique WTS_CURRENT_SERVER_HANDLE para indicar o servidor Host da Sessão de Área de Trabalho Remota no qual o aplicativo está sendo executado.

[in] SessionId

Um identificador de sessão dos Serviços de Área de Trabalho Remota. Para indicar a sessão atual, especifique WTS_CURRENT_SESSION. Você pode usar a função WTSEnumerateSessions para recuperar os identificadores de todas as sessões em um servidor host de sessão rd especificado.

Para enviar uma mensagem para a sessão de outro usuário, você precisa ter a permissão Mensagem. Para obter mais informações, consulte Serviços de Área de Trabalho Remota
Permissões. Para modificar permissões em uma sessão, use a ferramenta administrativa Configuração de Serviços de Área de Trabalho Remota.

[in] pTitle

Um ponteiro para uma cadeia de caracteres terminada em nulo para a barra de título da caixa de mensagem.

[in] TitleLength

O comprimento, em bytes, da cadeia de caracteres da barra de título.

[in] pMessage

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém a mensagem a ser exibida.

[in] MessageLength

O comprimento, em bytes, da cadeia de caracteres da mensagem.

[in] Style

O conteúdo e o comportamento da caixa de mensagem. Normalmente, esse valor é MB_OK. Para obter uma lista completa de valores, consulte o parâmetro uType da função MessageBox .

[in] Timeout

O tempo, em segundos, que a função WTSSendMessage aguarda a resposta do usuário. Se o usuário não responder dentro do intervalo de tempo limite, o parâmetro pResponse retornará IDTIMEOUT. Se o parâmetro Timeout for zero, WTSSendMessage aguardará indefinidamente para que o usuário responda.

[out] pResponse

Um ponteiro para uma variável que recebe a resposta do usuário, que pode ser um dos valores a seguir.

IDABORT (3)

Anular

IDCANCEL (2)

Cancelar

IDCONTINUE (11)

Continuar

IDIGNORE (5)

Ignorar

IDNO (7)

Não

IDOK (1)

OK

IDRETRY (4)

Tentar Novamente

IDTRYAGAIN (10)

Tentar novamente

IDYES (6)

Sim

IDASYNC (32001 (0x7D01))

O parâmetro bWait era FALSE, portanto, a função retornou sem aguardar uma resposta.

IDTIMEOUT (32000 (0x7D00))

O parâmetro bWait era TRUE e o intervalo de tempo limite decorrido.

[in] bWait

Se TRUE, WTSSendMessage não retornará até que o usuário responda ou o intervalo de tempo limite se esgoce. Se o parâmetro Timeout for zero, a função não retornará até que o usuário responda.

Se FALSE, a função retornará imediatamente e o parâmetro pResponseretornará IDASYNC. Use esse método para mensagens de informações simples (como mensagens de notificação de trabalho de impressão) que não precisam retornar a resposta do usuário ao programa de chamada.

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 WTSSendMessage 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
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wtsapi32.h
Biblioteca	Wtsapi32.lib
DLL	Wtsapi32.dll

Confira também

Messagebox