struttura WTS_SESSION_INFO_1A (wtsapi32.h)

Articolo
11/20/2024

Contiene informazioni estese su una sessione client in un server Host sessione Desktop remoto (Host sessione Desktop remoto) o in un server Remote Desktop Virtualization Host (Rd Virtualization Host).

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;

Membri

ExecEnvId

Identificatore che identifica in modo univoco la sessione all'interno dell'elenco di sessioni restituite dalla funzione WTSEnumerateSessionsEx . Per altre informazioni, vedere 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 è in esecuzione 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 connesso alla sessione. Se nessun utente è connesso 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 nessun utente è connesso 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 unita a una farm, la stringa contiene NULL.

Osservazioni

La funzione WTSEnumerateSessionsEx restituisce questa struttura se si chiama la funzione e si specifica un handle per 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, nonché 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 nel 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 in macchine virtuali unite 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 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 7
server minimo supportato	Windows Server 2008 R2
intestazione	wtsapi32.h

Vedere anche

WTSEnumerateSessionsEx

WTS_SESSION_INFO

Condividi tramite