Win32_OperatingSystem 클래스의 Win32ShutdownTracker 메서드

Win32ShutdownTracker 메서드는 Win32_OperatingSystemWin32Shutdown 메서드에서 지원하는 것과 동일한 종료 옵션 집합을 제공하지만 주석, 종료 이유 또는 시간 제한을 지정할 수도 있습니다.

구문

uint32 Win32ShutdownTracker(
  [in] uint32 Timeout,
  [in] string Comment,
  [in] uint32 ReasonCode,
  [in] sint32 Flags
);

매개 변수

시간 제한 [in]

종료가 발생하기 전의 시간(초)입니다. 기본값은 0입니다.

주석 [in]

이벤트 로그 항목에 주석으로 저장되는 종료 대화 상자에 표시할 메시지입니다.

ReasonCode [in]

종료를 시작하는 이유입니다.

Flags [in]

컴퓨터를 종료할 플래그의 비트맵 집합입니다. 명령을 강제로 적용하려면 명령 값에 Force 플래그(4)를 추가합니다. 강제를 원격 컴퓨터에서 종료 또는 다시 부팅과 함께 사용하면 모든 항목(WMI, COM 등 포함)이 즉시 종료되거나 원격 컴퓨터가 다시 부팅됩니다. 이로 인해 확정되지 않은 반환 값이 생성됩니다.

0(0x0)

로그오프

4(0x4)

강제 로그오프(0 + 4)

1(0x1)

종료

5(0x5)

강제 종료(1 + 4)

2(0x2)

Reboot

6(0x6)

강제 다시 부팅(2 + 4)

8(0x8)

전원 끄기

12(0xC)

강제 전원 끄기(8 + 4)

반환 값

성공을 나타내기 위해 0을 반환합니다. 다른 모든 숫자는 오류를 나타냅니다. 오류 코드는 WMI 오류 상수 또는 WbemErrorEnum을 참조하세요. 일반적인 HRESULT 값은시스템 오류 코드를 참조하세요.

성공 (0)

기타 (1-4294967295)

설명

호출 프로세스에는 SE_SHUTDOWN_NAME 권한이 있어야 합니다.

예제

다음 VBScript 코드 샘플에서는 Win32ShutdownTracker를 호출하는 방법을 설명합니다.

Set objArgs = Wscript.Arguments 

intTimeOut = objArgs(0) 'Countdown time (in seconds) before action
strComment = objArgs(1) 'Message to display
intFlags = objArgs(2) 'Set of flags to shutdown the computer:
'0 = Logoff, 4 = Forced Logoff (0+4), 1 = Shutdown, 2 = Reboot, 6 = Forced Reboot (2+4), 8 = Power Off, 12 = Forced Power Off (8+4) - 2 (Reboot) 

strComputer = "." 

Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate,(Shutdown)}!\\" & strComputer & "\root\cimv2")

Set colOperatingSystems = objWMIService.ExecQuery ("Select * from Win32_OperatingSystem") 

For Each objOperatingSystem in colOperatingSystems 
objOperatingSystem.Win32ShutdownTracker intTimeOut,strComment,0,intFlags 
Next

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

추가 정보

운영 체제 클래스

Win32_OperatingSystem

Win32Shutdown