Funzione WTSSendMessageA (wtsapi32.h)

Articolo
03/04/2024

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)

IDOK (1)

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

Vedi anche

MessageBox