WTSDisconnectSession 함수(wtsapi32.h)

세션을 닫지 않고 지정된 원격 데스크톱 서비스 세션에서 로그온한 사용자의 연결을 끊습니다. 이후에 사용자가 동일한 RD 세션 호스트(RD 세션 호스트) 서버에 로그온하는 경우 사용자는 동일한 세션에 다시 연결됩니다.

구문

BOOL WTSDisconnectSession(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] BOOL   bWait
);

[in] hServer

RD 세션 호스트 서버에 대한 핸들입니다. WTSOpenServer 또는 WTSOpenServerEx 함수에서 연 핸들을 지정하거나 WTS_CURRENT_SERVER_HANDLE 지정하여 애플리케이션이 실행 중인 RD 세션 호스트 서버를 나타냅니다.

[in] SessionId

원격 데스크톱 서비스 세션 식별자입니다. 현재 세션을 나타내려면 WTS_CURRENT_SESSION 지정합니다. 지정된 RD 세션 호스트 서버에서 모든 세션의 식별자를 검색하려면 WTSEnumerateSessions 함수를 사용합니다.

다른 사용자의 세션 연결을 끊려면 연결 끊기 권한이 있어야 합니다. 자세한 내용은 원격 데스크톱 서비스 권한을 참조하세요. 세션에 대한 권한을 수정하려면 원격 데스크톱 서비스 구성 관리 도구를 사용합니다.

RD 가상화 호스트 서버에서 호스트되는 가상 머신에서 실행되는 세션의 연결을 끊려면 RD 가상화 호스트 서버의 Administrators 그룹의 구성원이어야 합니다.

[in] bWait

작업이 동기식인지 여부를 나타냅니다. 작업이 완료되기를 기다리려면 TRUE 를 지정하고 FALSE 를 지정하면 즉시 반환됩니다.

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

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