Función WTSSendMessageA (wtsapi32.h)

Muestra un cuadro de mensaje en el escritorio cliente de una sesión de Servicios de Escritorio remoto especificada.

Sintaxis

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

Identificador de un servidor host de sesión de Escritorio remoto. Especifique un identificador abierto por la función WTSOpenServer o especifique WTS_CURRENT_SERVER_HANDLE para indicar el servidor host de sesión de Escritorio remoto en el que se ejecuta la aplicación.

[in] SessionId

Identificador de sesión de Servicios de Escritorio remoto. Para indicar la sesión actual, especifique WTS_CURRENT_SESSION. Puede usar la función WTSEnumerateSessions para recuperar los identificadores de todas las sesiones en un servidor host de sesión de Escritorio remoto especificado.

Para enviar un mensaje a la sesión de otro usuario, debe tener el permiso Mensaje. Para obtener más información, consulte Servicios de Escritorio remoto.
Permisos. Para modificar permisos en una sesión, use la herramienta administrativa Configuración de Servicios de Escritorio remoto.

[in] pTitle

Puntero a una cadena terminada en null para la barra de título del cuadro de mensaje.

[in] TitleLength

Longitud, en bytes, de la cadena de la barra de título.

[in] pMessage

Puntero a una cadena terminada en null que contiene el mensaje que se va a mostrar.

[in] MessageLength

Longitud, en bytes, de la cadena de mensaje.

[in] Style

Contenido y comportamiento del cuadro de mensaje. Este valor suele ser MB_OK. Para obtener una lista completa de valores, vea el parámetro uType de la función MessageBox .

[in] Timeout

El tiempo, en segundos, que la función WTSSendMessage espera la respuesta del usuario. Si el usuario no responde dentro del intervalo de tiempo de espera, el parámetro pResponse devuelve IDTIMEOUT. Si el parámetro Timeout es cero, WTSSendMessage espera indefinidamente para que el usuario responda.

[out] pResponse

Puntero a una variable que recibe la respuesta del usuario, que puede ser uno de los valores siguientes.

IDABORT (3)

Anulación

IDCANCEL (2)

Cancelar

IDCONTINUE (11)

Continuar

IDIGNORE (5)

Omitir

IDNO (7)

No

IDOK (1)

OK (CORRECTO)

IDRETRY (4)

Retry

IDTRYAGAIN (10)

Vuelve a intentarlo

IDYES (6)

Sí

IDASYNC (32001 (0x7D01))

El parámetro bWait era FALSE, por lo que la función devolvió sin esperar una respuesta.

IDTIMEOUT (32000 (0x7D00))

El parámetro bWait era TRUE y el intervalo de tiempo de espera transcurrido.

[in] bWait

Si es TRUE, WTSSendMessage no devuelve hasta que el usuario responde o transcurre el intervalo de tiempo de espera. Si el parámetro Timeout es cero, la función no devuelve hasta que el usuario responde.

Si es FALSE, la función devuelve inmediatamente y el parámetro pResponse devuelve IDASYNC. Use este método para mensajes de información simples (como mensajes de notificación de trabajos de impresión) que no necesitan devolver la respuesta del usuario al programa de llamada.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Nota

El encabezado wtsapi32.h define WTSSendMessage como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wtsapi32.h
Library	Wtsapi32.lib
Archivo DLL	Wtsapi32.dll

Consulte también

Cuadro de mensajes