структура WTS_SESSION_INFO_1W (wtsapi32.h)
Содержит расширенные сведения о сеансе клиента на сервере узла сеансов удаленных рабочих столов (узел сеансов удаленных рабочих столов) или узле виртуализации удаленных рабочих столов (узел виртуализации удаленных рабочих столов).
Синтаксис
typedef struct _WTS_SESSION_INFO_1W {
DWORD ExecEnvId;
WTS_CONNECTSTATE_CLASS State;
DWORD SessionId;
LPWSTR pSessionName;
LPWSTR pHostName;
LPWSTR pUserName;
LPWSTR pDomainName;
LPWSTR pFarmName;
} WTS_SESSION_INFO_1W, *PWTS_SESSION_INFO_1W;
Члены
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 |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по