WTS_SESSION_INFO_1A 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_1A {
  DWORD                  ExecEnvId;
  WTS_CONNECTSTATE_CLASS State;
  DWORD                  SessionId;
  LPSTR                  pSessionName;
  LPSTR                  pHostName;
  LPSTR                  pUserName;
  LPSTR                  pDomainName;
  LPSTR                  pFarmName;
} WTS_SESSION_INFO_1A, *PWTS_SESSION_INFO_1A;

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

Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Intestazione	wtsapi32.h

Vedi anche

WTSEnumerateSessionsEx

WTS_SESSION_INFO