Поделиться через

структура WTS_SESSION_INFO_1A (wtsapi32.h)

  • Статья

Содержит расширенные сведения о сеансе клиента на сервере узла сеансов удаленных рабочих столов (узел сеансов удаленных рабочих столов) или узле виртуализации удаленных рабочих столов (узел виртуализации удаленных рабочих столов).

Синтаксис

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;

Члены

ExecEnvId

Идентификатор, однозначно определяющий сеанс в списке сеансов, возвращаемых функцией WTSEnumerateSessionsEx . Дополнительные сведения см. в подразделе "Примечания".

State

Значение типа перечисления WTS_CONNECTSTATE_CLASS , указывающее состояние подключения сеанса служб удаленных рабочих столов.

SessionId

Идентификатор сеанса, назначенный сервером узла сеансов удаленных рабочих столов, сервером узла виртуализации удаленных рабочих стола или виртуальной машиной.

pSessionName

Указатель на строку, завершающуюся значением NULL, которая содержит имя этого сеанса. Например, "services", "console" или "RDP-Tcp#0".

pHostName

Указатель на строку, завершающуюся значением NULL, которая содержит имя компьютера, на котором выполняется сеанс. Если сеанс выполняется непосредственно на сервере узла сеансов удаленных рабочих стола или на сервере узла виртуализации удаленных рабочих стола, строка содержит значение NULL. Если сеанс выполняется на виртуальной машине, строка содержит имя виртуальной машины.

pUserName

Указатель на строку, завершающуюся значением NULL, которая содержит имя пользователя, выполнившего вход в сеанс. Если пользователь не вошел в сеанс, строка содержит значение NULL.

pDomainName

Указатель на строку, завершающуюся значением NULL, которая содержит доменное имя пользователя, вошедшего в сеанс. Если пользователь не вошел в сеанс, строка содержит значение NULL.

pFarmName

Указатель на строку, завершающуюся значением NULL, которая содержит имя фермы, к которому присоединена виртуальная машина. Если сеанс не выполняется на виртуальной машине, присоединенной к ферме, строка содержит значение NULL.

Комментарии

Функция WTSEnumerateSessionsEx возвращает эту структуру, если вызвать функцию и указать дескриптор сервера узла виртуализации удаленных рабочих столов, полученный путем вызова функции WTSOpenServerEx . В этом случае функция WTSEnumerateSessionsEx объединяет все сеансы , выполняемые на самом узле, а также сеансы, выполняемые на отдельных виртуальных машинах. Параметр ExecEnvId однозначно определяет каждый сеанс в агрегированном списке. Этот идентификатор может отличаться от фактического идентификатора сеанса, определенного на сервере или виртуальной машине, на которой размещен сеанс, который задается членом SessionId .

Сеанс, представленный этой структурой, может быть сеансом, запущенным непосредственно на сервере, или сеансом, выполняемым на виртуальной машине. Если сеанс выполняется на виртуальной машине, элемент pHostName содержит имя виртуальной машины. Член pFarmName применим к сеансам, размещенным на виртуальных машинах, присоединенных к ферме узлов сеансов удаленных рабочих столов.

Примечание

Заголовок wtsapi32.h определяет WTS_SESSION_INFO_1 в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

   
Минимальная версия клиента Windows 7
Минимальная версия сервера Windows Server 2008 R2
Верхняя часть wtsapi32.h

См. также раздел

WTSEnumerateSessionsEx

WTS_SESSION_INFO