Funzione WTSSendMessageA (wtsapi32.h)

Articolo
11/20/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
Autorizzazioni. Per modificare le autorizzazioni per una sessione, usare lo strumento di amministrazione configurazione di 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 dei valori, vedere il parametro uType della funzione MessageBox .

[in] Timeout

Tempo, in secondi, in cui la funzione WTSSendMessage attende la risposta dell'utente. Se l'utente non risponde entro l'intervallo di timeout, il parametro pResponse restituisce IDTIMEOUT. 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)

interruzione

IDCANCEL (2)

Annulla

IDCONTINUE (11)

Continua

IDIGNORE (5)

Ignora

IDNO (7)

nessuna

IDOK (1)

IDRETRY (4)

riprovare

IDTRYAGAIN (10)

riprovare

IDYES (6)

sì

IDASYNC (32001 (0x7D01))

Il parametro bWait è stato FALSE, quindi la funzione restituita senza attendere una risposta.

IDTIMEOUT (32000 (0x7D00))

Il parametro bWait è stato true e l'intervallo di timeout trascorso.

[in] bWait

Se TRUE, WTSSendMessage non restituisce finché l'utente non risponde o non scade l'intervallo di timeout. Se il parametro Timeout è zero, la funzione non restituisce finché l'utente non risponde.

Se FALSE, la funzione restituisce immediatamente e il parametro pResponse restituisce IDASYNC. Utilizzare questo metodo per messaggi di informazioni semplici,ad esempio i messaggi di notifica del processo di stampa, 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	wtsapi32.h
libreria	Wtsapi32.lib
dll	Wtsapi32.dll

Vedere anche

MessageBox

Condividi tramite