Msvm_ConcreteJob 類別的 RequestStateChange 方法

要求將作業的狀態變更為指定的狀態。 多次叫用 RequestStateChange 方法可能會導致先前的要求遭到覆寫或遺失。 如果傳回 0，則工作成功完成。 任何其他傳回碼都表示錯誤狀況。

語法

uint32 RequestStateChange(
  [in] uint16   RequestedState,
  [in] datetime TimeoutPeriod
);

參數

RequestedState [in]

類型： uint16

作業的新狀態。

開始 (2)

將狀態變更為「執行中」。

暫停 (3)

暫時停止作業。 目的是後續使用 「Start」 重新開機作業。 暫停時可能進入「服務」狀態。 (這是作業特定的。)

終止 (4)

以正常方式停止作業、儲存資料、保留狀態，以及依序關閉所有基礎進程。

kill (5)

立即終止作業，不需要儲存資料或保留狀態。

服務 (6)

將作業放入廠商特定的服務狀態。 可能會重新開機作業。

DMTF 保留

保留的。

廠商保留

保留的。

TimeoutPeriod [in]

類型： datetime

逾時期間，指定用戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定逾時期間。 值為 0 或 Null 表示用戶端沒有轉換的時間需求。 如果這個屬性不包含 0 或 Null ，而且實作不支援此參數，則必須傳回傳回 4098 (使用不支援的逾時參數) 。

傳回值

類型： uint32

這個方法會傳回下列其中一個值。

已完成，沒有錯誤 (0)

不支援 (1)

未知/未指定的錯誤 (2)

無法在逾時期間內完成 (3)

失敗 (4)

不正確參數 (5)

在 [使用 (6)

DMTF 保留 (7 4095)

已檢查方法參數 - 轉換開始 (4096)

不正確狀態轉換 (4097)

不支援使用逾時參數 (4098)

忙碌 (4099)

保留 的方法 (4100 32767)

廠商特定 (32768 65535)

備註

UAC 篩選可能會限制 存取Msvm_ConcreteJob 類別。 如需詳細資訊，請參閱 使用者帳戶控制和 WMI。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
命名空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

另請參閱

Msvm_ConcreteJob