다음을 통해 공유


WTSShutdownSystem 함수(wtsapi32.h)

지정된 RD 세션 호스트(원격 데스크톱 세션 호스트) 서버를 종료하고 필요에 따라 다시 시작합니다.

시스템을 종료하거나 다시 시작하려면 호출 프로세스에 SE_SHUTDOWN_NAME 권한이 활성화되어 있어야 합니다. 보안 권한에 대한 자세한 내용은 권한권한 부여 상수를 참조하세요.

구문

BOOL WTSShutdownSystem(
  [in] HANDLE hServer,
  [in] DWORD  ShutdownFlag
);

매개 변수

[in] hServer

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

[in] ShutdownFlag

종료 유형을 나타냅니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

WTS_WSD_LOGOFF

WTSShutdownSystem을 호출하는 세션을 제외하고 모든 클라이언트 세션이 로그오프되도록 하고 후속 원격 로그온을 사용하지 않도록 설정합니다. 종료하기 전에 단계로 사용할 수 있습니다. 원격 데스크톱 서비스 서비스를 다시 시작하면 로그온이 다시 활성화됩니다.

원격 데스크톱 서비스 콘솔에서만 이 값을 사용합니다.

WTS_WSD_POWEROFF

RD 세션 호스트 서버에서 시스템을 종료하고 AC 전원의 소프트웨어 제어를 지원하는 컴퓨터에서 전원을 끕니다. 이는 EWX_SHUTDOWN 및 EWX_POWEROFF사용하여 ExitWindowsEx를 호출하는 것과 같습니다. 호출 프로세스에는 SE_SHUTDOWN_NAME 권한이 활성화되어 있어야 합니다.

WTS_WSD_REBOOT

를 종료한 다음 RD 세션 호스트 서버에서 시스템을 다시 시작합니다. 이는 EWX_REBOOT사용하여 ExitWindowsEx를 호출하는 것과 같습니다. 호출 프로세스에는 SE_SHUTDOWN_NAME 권한이 활성화되어 있어야 합니다.

WTS_WSD_SHUTDOWN

RD 세션 호스트 서버에서 시스템을 종료합니다. 이는 EWX_SHUTDOWN사용하여 ExitWindowsEx 함수를 호출하는 것과 같습니다. 호출 프로세스에는 SE_SHUTDOWN_NAME 권한이 활성화되어 있어야 합니다.

WTS_WSD_FASTREBOOT

이 값은 현재 지원되지 않습니다.

반환 값

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

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

설명

시스템 종료는 모든 사용자 및 활성 프로그램을 종료합니다. 다음 단계는 종료 중에 발생합니다.

  1. 종료 명령은 모든 활성 사용자 애플리케이션에 발급됩니다.
  2. 애플리케이션이 특정 간격 내에 종료되지 않으면 애플리케이션이 종료됩니다.
  3. 사용자에 대한 모든 애플리케이션이 종료되면 사용자가 로그오프됩니다.
  4. 모든 사용자가 로그오프되면 모든 시스템 서비스에 종료 명령이 실행됩니다.
  5. 시스템 서비스가 특정 간격 내에 종료되지 않으면 서비스가 종료됩니다.
  6. 파일 시스템 캐시는 디스크에 기록됩니다.
  7. 디스크는 읽기 전용으로 표시됩니다.
  8. RD 세션 호스트 서버에 "이제 컴퓨터를 끄면 안전합니다."라는 메시지가 표시되거나 WTS_WSD_REBOOT 지정된 경우 시스템이 다시 시작됩니다. (모든 클라이언트 세션이 종료되었기 때문에 메시지가 콘솔에 표시됩니다.)
참고 대규모 다중 사용자 구성에는 많은 사용자 및 프로세스가 있을 수 있으므로 대규모 시스템 구성은 순서대로 종료하는 데 다소 시간이 걸릴 수 있습니다. 시스템이 완전히 종료되도록 하는 것이 중요합니다.
 
Windows Server 2008 및 Windows Vista: RCM(원격 연결 관리자)을 사용하지 않도록 설정하면 WTSShutdownSystem에 대한 호출이 작동하지 않습니다. 원격 데스크톱 서비스 서비스가 중지된 경우입니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 wtsapi32.h
라이브러리 Wtsapi32.lib
DLL Wtsapi32.dll

추가 정보

ExitWindowsEx