WTSLogoffSession 함수(wtsapi32.h)
지정된 원격 데스크톱 서비스 세션을 로그오프합니다.
구문
BOOL WTSLogoffSession(
[in] HANDLE hServer,
[in] DWORD SessionId,
[in] BOOL bWait
);
매개 변수
[in] hServer
RD 세션 호스트 서버에 대한 핸들입니다. WTSOpenServer 또는 WTSOpenServerEx 함수에서 연 핸들을 지정하거나 WTS_CURRENT_SERVER_HANDLE 지정하여 애플리케이션이 실행 중인 RD 세션 호스트 서버를 나타냅니다.
[in] SessionId
원격 데스크톱 서비스 세션 식별자입니다. 현재 세션을 나타내려면 WTS_CURRENT_SESSION 지정합니다. WTSEnumerateSessions 함수를 사용하여 지정된 RD 세션 호스트 서버에서 모든 세션의 식별자를 검색할 수 있습니다.
다른 사용자의 세션을 로그오프하려면 다시 설정 권한이 있어야 합니다. 자세한 내용은 원격 데스크톱 서비스 권한을 참조하세요. 세션에 대한 권한을 수정하려면 원격 데스크톱 서비스 구성 관리 도구를 사용합니다.
RD 가상화 호스트 서버에서 호스트되는 가상 머신에서 실행되는 세션을 로그오프하려면 RD 가상화 호스트 서버의 Administrators 그룹의 구성원이어야 합니다.
[in] bWait
작업이 동기인지 여부를 나타냅니다.
bWait이 TRUE이면 세션이 로그오프되면 함수가 반환됩니다.
bWait이 FALSE이면 함수가 즉시 반환됩니다. 세션이 로그오프되었는지 확인하려면 WTSQuerySessionInformation 함수에 대한 호출에서 세션 식별자를 지정합니다. WTSQuerySessionInformation 은 세션이 로그오프된 경우 0을 반환합니다.
반환 값
함수가 성공하면 반환 값은 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 도입) |