WTS_SESSION_INFO_1A 구조체(wtsapi32.h)
RD 세션 호스트(원격 데스크톱 세션 호스트) 서버 또는 RD 가상화 호스트(원격 데스크톱 가상화 호스트) 서버의 클라이언트 세션에 대한 확장된 정보를 포함합니다.
통사론
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
RD 세션 호스트 서버, RD 가상화 호스트 서버 또는 가상 머신에서 할당한 세션 식별자입니다.
pSessionName
이 세션의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 예를 들어 "services", "console" 또는 "RDP-Tcp#0"입니다.
pHostName
세션이 실행 중인 컴퓨터의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 세션이 RD 세션 호스트 서버 또는 RD 가상화 호스트 서버에서 직접 실행되는 경우 문자열에는 NULL포함됩니다. 세션이 가상 머신에서 실행되는 경우 문자열에는 가상 머신의 이름이 포함됩니다.
pUserName
세션에 로그온한 사용자의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 세션에 로그온한 사용자가 없으면 문자열에 NULL포함됩니다.
pDomainName
세션에 로그온한 사용자의 도메인 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 세션에 로그온한 사용자가 없으면 문자열에 NULL포함됩니다.
pFarmName
가상 머신이 조인된 팜의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 팜에 조인된 가상 머신에서 세션이 실행되고 있지 않으면 문자열에 NULL포함됩니다.
발언
WTSEnumerateSessionsEx 함수는 함수를 호출하고 WTSOpenServerEx 함수를 호출하여 가져온 RD 가상화 호스트 서버에 대한 핸들을 지정하는 경우 이 구조를 반환합니다. 이 경우 WTSEnumerateSessionsEx 함수는 호스트 자체에서 실행되는 모든 세션과 개별 가상 머신에서 실행되는 세션을 집계합니다. ExecEnvId 매개 변수는 집계된 목록의 각 세션을 고유하게 식별합니다. 이 식별자는 SessionId 멤버에 의해 지정된 세션을 호스트하는 서버 또는 가상 머신에 정의된 실제 세션 식별자와 다를 수 있습니다.
이 구조가 나타내는 세션은 서버에서 직접 실행되는 세션 또는 가상 머신 내에서 실행되는 세션일 수 있습니다. 세션이 가상 머신 내에서 실행되는 경우 pHostName 멤버에는 가상 머신의 이름이 포함됩니다. pFarmName 멤버는 RD 세션 호스트 팜에 조인된 가상 머신에서 호스트되는 세션에 적용할 수 있습니다.
메모
wtsapi32.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 WTS_SESSION_INFO_1 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 |
| 지원되는 최소 서버 | Windows Server 2008 R2 |
| 헤더 | wtsapi32.h |