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 de
[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
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 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 del mensaje.
[in] Style
Contenido y comportamiento del cuadro de mensaje. Este valor suele ser MB_OK. Para obtener una lista completa de valores, consulte el parámetro
[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 de 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 siguientes valores.
IDABORT (3)
anular
IDCANCEL (2)
Cancelar
IDCONTINUE (11)
Continuar
IDIGNORE (5)
Omitir
IDNO (7)
No
IDOK (1)
aceptar
IDRETRY (4)
de reintento de
IDTRYAGAIN (10)
vuelva a intentar
IDYES (6)
sí
IDASYNC (32001 (0x7D01))
El parámetro bWait se FALSE, por lo que la función devolvió sin esperar una respuesta.
IDTIMEOUT (32000 (0x7D00))
El parámetro bWait se true y el intervalo de tiempo de espera transcurrido.
[in] bWait
Si TRUE, WTSSendMessage no devuelve hasta que el usuario responda o el intervalo de tiempo de espera transcurrido. Si el parámetro Timeout es cero, la función no devuelve hasta que el usuario responda.
Si 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 se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Observaciones
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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| servidor mínimo admitido | Windows Server 2008 |
| de la plataforma de destino de |
Windows |
| encabezado de |
wtsapi32.h |
| biblioteca de |
Wtsapi32.lib |
| DLL de |
Wtsapi32.dll |