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 |