Win32_OperatingSystem クラスの Win32ShutdownTracker メソッド

Win32ShutdownTracker メソッドは、Win32_OperatingSystemの Win32Shutdown メソッドでサポートされているシャットダウン オプションと同じセットを提供しますが、コメント、シャットダウンの理由、タイムアウトを指定することもできます。

構文

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

パラメーター

タイムアウト [入力]

シャットダウンが行われる前の時間 (秒単位)。 既定値は 0 (ゼロ) です。

コメント [入力]

シャットダウン ダイアログ ボックスに表示するメッセージ。イベント ログ エントリにもコメントとして格納されます。

ReasonCode [in]

シャットダウンを開始する理由。

Flags [in]

コンピューターをシャットダウンするためのフラグのビットマップ セット。 コマンドを強制するには、Force フラグ (4) をコマンド値に追加します。 Force をリモート コンピューターでシャットダウンまたは再起動と組み合わせて使用すると、すべての機能 (WMI、COM など) が直ちにシャットダウンされるか、リモート コンピューターが再起動されます。 これにより、不確定な戻り値が返されます。

0 (0x0)

ログオフ

4 (0x4)

強制ログオフ (0 + 4)

1 (0x1)

Shutdown

5 (0x5)

強制シャットダウン (1 + 4)

2 (0x2)

再起動

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