структура 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, содержащую имя этого сеанса. Например, "службы", "консоль" или "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 |