WTS_SESSION_INFO_1W struttura (wtsapi32.h)
Contiene informazioni estese su una sessione client in un server Host sessione Desktop remoto (host sessione Desktop remoto) o host di virtualizzazione Desktop remoto (host di virtualizzazione Desktop remoto).
Sintassi
typedef struct _WTS_SESSION_INFO_1W {
DWORD ExecEnvId;
WTS_CONNECTSTATE_CLASS State;
DWORD SessionId;
LPWSTR pSessionName;
LPWSTR pHostName;
LPWSTR pUserName;
LPWSTR pDomainName;
LPWSTR pFarmName;
} WTS_SESSION_INFO_1W, *PWTS_SESSION_INFO_1W;
Members
ExecEnvId
Identificatore che identifica in modo univoco la sessione all'interno dell'elenco di sessioni restituite dalla funzione WTSEnumerateSessionsEx . Per altre informazioni, vedere la sezione Osservazioni.
State
Valore del tipo di enumerazione WTS_CONNECTSTATE_CLASS che specifica lo stato di connessione di una sessione di Servizi Desktop remoto.
SessionId
Identificatore di sessione assegnato dal server host sessione Desktop remoto, dal server host di virtualizzazione Desktop remoto o dalla macchina virtuale.
pSessionName
Puntatore a una stringa con terminazione null contenente il nome di questa sessione. Ad esempio, "services", "console" o "RDP-Tcp#0".
pHostName
Puntatore a una stringa con terminazione null contenente il nome del computer in cui è in esecuzione la sessione. Se la sessione viene eseguita direttamente in un server host sessione Desktop remoto o in un server host di virtualizzazione Desktop remoto, la stringa contiene NULL. Se la sessione è in esecuzione in una macchina virtuale, la stringa contiene il nome della macchina virtuale.
pUserName
Puntatore a una stringa con terminazione null contenente il nome dell'utente che ha eseguito l'accesso alla sessione. Se non viene eseguito l'accesso dell'utente alla sessione, la stringa contiene NULL.
pDomainName
Puntatore a una stringa con terminazione null contenente il nome di dominio dell'utente connesso alla sessione. Se non viene eseguito l'accesso dell'utente alla sessione, la stringa contiene NULL.
pFarmName
Puntatore a una stringa con terminazione null contenente il nome della farm a cui viene unita la macchina virtuale. Se la sessione non è in esecuzione in una macchina virtuale aggiunta a una farm, la stringa contiene NULL.
Commenti
La funzione WTSEnumerateSessionsEx restituisce questa struttura se si chiama la funzione e si specifica un handle in un server host di virtualizzazione Desktop remoto ottenuto chiamando la funzione WTSOpenServerEx . In questo caso, la funzione WTSEnumerateSessionsEx aggrega tutte le sessioni in esecuzione nell'host stesso e le sessioni in esecuzione in singole macchine virtuali. Il parametro ExecEnvId identifica in modo univoco ogni sessione nell'elenco aggregato. Questo identificatore può essere diverso dall'identificatore di sessione effettivo definito nel server o nella macchina virtuale che ospita la sessione, specificata dal membro SessionId .
La sessione rappresentata da questa struttura potrebbe essere una sessione in esecuzione direttamente sul server o una sessione in esecuzione all'interno di una macchina virtuale. Se la sessione è in esecuzione all'interno di una macchina virtuale, il membro pHostName contiene il nome della macchina virtuale. Il membro pFarmName è applicabile alle sessioni ospitate nelle macchine virtuali aggiunte a una farm host sessione Desktop remoto.
Nota
L'intestazione wtsapi32.h definisce WTS_SESSION_INFO_1 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 7 |
| Server minimo supportato | Windows Server 2008 R2 |
| Intestazione | wtsapi32.h |