다음을 통해 공유


WTSEnumerateSessionsA 함수(wtsapi32.h)

RD 세션 호스트(원격 데스크톱 세션 호스트) 서버에서 세션 목록을 검색합니다.

구문

BOOL WTSEnumerateSessionsA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_SESSION_INFOA *ppSessionInfo,
  [out] DWORD              *pCount
);

매개 변수

[in] hServer

RD 세션 호스트 서버에 대한 핸들입니다.

참고WTSOpenServer 또는 WTSOpenServerEx 함수를 사용하여 특정 서버에 대한 핸들을 검색하거나 WTS_CURRENT_SERVER_HANDLE 애플리케이션을 호스트하는 RD 세션 호스트 서버를 사용할 수 있습니다.
 

[in] Reserved

이 매개 변수는 예약되어 있습니다. 0이어야 합니다.

[in] Version

열거형 요청의 버전입니다. 이 매개 변수는 1이어야 합니다.

[out] ppSessionInfo

검색된 세션을 나타내는 WTS_SESSION_INFO 구조체 배열에 대한 포인터입니다. 반환된 버퍼를 해제하려면 WTSFreeMemory 함수를 호출합니다.

세션 권한:

  • 세션을 열거하려면 쿼리 정보 권한을 사용하도록 설정해야 합니다. 자세한 내용은 원격 데스크톱 서비스 권한을 참조하세요.
  • 세션에 대한 권한을 변경하려면 원격 데스크톱 서비스 구성 관리 도구를 사용합니다.
  • RD 가상화 호스트 서버에서 호스트되는 가상 머신에서 실행되는 세션을 열거하려면 RD 가상화 호스트 서버의 Administrators 그룹의 구성원이어야 합니다.

[out] pCount

ppSessionInfo 매개 변수에 반환된 WTS_SESSION_INFO 구조체 수에 대한 포인터입니다.

반환 값

이 함수가 실패하면 0을 반환합니다. 이 함수가 성공하면 0이 아닌 값이 반환됩니다.

확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

참고

wtsapi32.h 헤더는 WTSEnumerateSessions를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 wtsapi32.h
라이브러리 Wtsapi32.lib
DLL Wtsapi32.dll
API 세트 ext-ms-win-session-wtsapi32-l1-1-0(Windows 8 도입)

추가 정보

WTS_SESSION_INFO