estructura de WTS_SESSION_INFO_1A (wtsapi32.h)

  • Artículo

Contiene información extendida sobre una sesión de cliente en un servidor host de sesión de Escritorio remoto (host de sesión de Escritorio remoto) o en un servidor host de virtualización de Escritorio remoto (host de virtualización de Escritorio remoto).

Sintaxis

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;

Miembros

ExecEnvId

Identificador que identifica de forma única la sesión dentro de la lista de sesiones devueltas por la función WTSEnumerateSessionsEx . Para obtener más información, vea la sección Comentarios.

State

Valor del tipo de enumeración WTS_CONNECTSTATE_CLASS que especifica el estado de conexión de una sesión de Servicios de Escritorio remoto.

SessionId

Identificador de sesión asignado por el servidor host de sesión de Escritorio remoto, el servidor host de virtualización de Escritorio remoto o la máquina virtual.

pSessionName

Puntero a una cadena terminada en null que contiene el nombre de esta sesión. Por ejemplo, "services", "console" o "RDP-Tcp#0".

pHostName

Puntero a una cadena terminada en null que contiene el nombre del equipo en el que se ejecuta la sesión. Si la sesión se ejecuta directamente en un servidor host de sesión de Escritorio remoto o en un servidor host de virtualización de Escritorio remoto, la cadena contiene NULL. Si la sesión se ejecuta en una máquina virtual, la cadena contiene el nombre de la máquina virtual.

pUserName

Puntero a una cadena terminada en null que contiene el nombre del usuario que ha iniciado sesión en la sesión. Si ningún usuario ha iniciado sesión en la sesión, la cadena contiene NULL.

pDomainName

Puntero a una cadena terminada en null que contiene el nombre de dominio del usuario que ha iniciado sesión en la sesión. Si ningún usuario ha iniciado sesión en la sesión, la cadena contiene NULL.

pFarmName

Puntero a una cadena terminada en null que contiene el nombre de la granja a la que está unida la máquina virtual. Si la sesión no se ejecuta en una máquina virtual que está unida a una granja de servidores, la cadena contiene NULL.

Observaciones

La función WTSEnumerateSessionsEx devuelve esta estructura si llama a la función y especifica un identificador para un servidor host de virtualización de Escritorio remoto que obtuvo llamando a la función WTSOpenServerEx . En este caso, la función WTSEnumerateSessionsEx agrega todas las sesiones que se ejecutan en el propio host, así como las sesiones que se ejecutan en máquinas virtuales individuales. El parámetro ExecEnvId identifica de forma única cada sesión de la lista agregada. Este identificador puede ser diferente del identificador de sesión real definido en el servidor o la máquina virtual que hospeda la sesión, que especifica el miembro SessionId .

La sesión representada por esta estructura podría ser una sesión que se ejecuta directamente en el servidor o una sesión que se ejecuta dentro de una máquina virtual. Si la sesión se ejecuta en una máquina virtual, el miembro pHostName contiene el nombre de la máquina virtual. El miembro pFarmName es aplicable a las sesiones hospedadas en máquinas virtuales unidas a una granja de hosts de sesión de Escritorio remoto.

Nota

El encabezado wtsapi32.h define WTS_SESSION_INFO_1 como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows 7
Servidor mínimo compatible Windows Server 2008 R2
Encabezado wtsapi32.h

Consulte también

WTSEnumerateSessionsEx

WTS_SESSION_INFO