Funzione WTSSendMessageA (wtsapi32.h)
Visualizza una finestra di messaggio sul desktop client di una sessione di Servizi Desktop remoto specificata.
Sintassi
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
);
Parametri
[in] hServer
Handle per un server host sessione Desktop remoto. Specificare un handle aperto dalla funzione WTSOpenServer oppure specificare WTS_CURRENT_SERVER_HANDLE per indicare il server Host sessione Desktop remoto in cui è in esecuzione l'applicazione.
[in] SessionId
Identificatore di sessione di Servizi Desktop remoto. Per indicare la sessione corrente, specificare WTS_CURRENT_SESSION. È possibile usare la funzione WTSEnumerateSessions per recuperare gli identificatori di tutte le sessioni in un server host sessione Desktop remoto specificato.
Per inviare un messaggio alla sessione di un altro utente, è necessario disporre dell'autorizzazione Message. Per altre informazioni, vedere Servizi Desktop remoto
Permissions (Avanti: Autorizzazioni). Per modificare le autorizzazioni in una sessione, usare lo strumento di amministrazione Configurazione servizi Desktop remoto.
[in] pTitle
Puntatore a una stringa con terminazione null per la barra del titolo della finestra di messaggio.
[in] TitleLength
Lunghezza, in byte, della stringa della barra del titolo.
[in] pMessage
Puntatore a una stringa con terminazione null contenente il messaggio da visualizzare.
[in] MessageLength
Lunghezza, in byte, della stringa del messaggio.
[in] Style
Contenuto e comportamento della finestra di messaggio. Questo valore è in genere MB_OK. Per un elenco completo di valori, vedere il parametro uType della funzione MessageBox .
[in] Timeout
Il tempo, in secondi, che la funzione WTSSendMessage attende la risposta dell'utente. Se l'utente non risponde entro l'intervallo di timeout, il parametro pResponse restituisceIDTIMEOUT. Se il parametro Timeout è zero, WTSSendMessage attende in modo indefinito che l'utente risponda.
[out] pResponse
Puntatore a una variabile che riceve la risposta dell'utente, che può essere uno dei valori seguenti.
IDABORT (3)
Interrompere
IDCANCEL (2)
Annulla
IDCONTINUE (11)
Continua
IDIGNORE (5)
Ignora
IDNO (7)
No
IDOK (1)
OK
IDRETRY (4)
Nuovo tentativo
IDTRYAGAIN (10)
Riprova
IDYES (6)
Sì
IDASYNC (32001 (0x7D01))
Il parametro bWait era FALSE, quindi la funzione restituita senza attendere una risposta.
IDTIMEOUT (32000 (0x7D00))
Il parametro bWait era TRUE e l'intervallo di timeout trascorso.
[in] bWait
Se TRUE, WTSSendMessage non restituisce fino a quando l'utente risponde o l'intervallo di timeout trascorso. Se il parametro Timeout è zero, la funzione non viene restituita finché l'utente risponde.
Se FALSE, la funzione restituisce immediatamente e il parametro pResponse restituisceIDASYNC. Usare questo metodo per i messaggi di informazioni semplici, ad esempio i messaggi di stampa dei processi di notifica, che non devono restituire la risposta dell'utente al programma chiamante.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Nota
L'intestazione wtsapi32.h definisce WTSSendMessage come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Server minimo supportato | Windows Server 2008 |
Piattaforma di destinazione | Windows |
Intestazione | wtsapi32.h |
Libreria | Wtsapi32.lib |
DLL | Wtsapi32.dll |