MSFT_StorageJob 類別的 RequestStateChange 方法
要求作業的狀態變更為 RequestedState 參數中指定的值。
語法
UInt32 RequestStateChange(
[in] UInt16 RequestedState,
[out] String ExtendedStatus
);
參數
RequestedState [in]
新狀態。
| 值 | 意義 |
|---|---|
| 開始 時間 2 | 這個值會將 JobState 屬性的值變更為 Running。 |
| 暫止 3 | 這個值會暫時停止作業。 其目的是要接著重新啟動作業，並呼叫 RequestStateChange 並將 RequestedState 參數設定為 Start。 作業在暫停時可能進入 服務 狀態。 (這是作業特定的。) |
| 終止 4 | 此值會以正常方式停止作業、儲存數據、保留狀態，以及依序關閉所有基礎進程。 |
| 終止 5 | 此值會立即終止作業，而不需要儲存數據或保留狀態。 |
| 服務 6 | 這個值會將作業放入廠商特定的服務狀態。 可能會重新啟動作業。 |
| DMTF 保留 7..32767 | 7 到 32767 (內含) 之間的值會保留給 DMTF。 |
| 廠商保留 32768..65535 | 32768 與 65535 (內含) 之間的值會保留給廠商。 |
ExtendedStatus [out]
包含內嵌 MSFT_StorageExtendedStatus 物件的字串。
此參數可讓儲存提供者傳回擴充 (實作特定) 錯誤資訊。
傳回值
成功 (0)
不支援 (1)
未指定的錯誤 (2)
逾 時 (3)
失敗 (4)
無效的參數 (5)
已檢查方法參數 - 作業啟動 (4096)
不支援大小 (4097)
(40001) 拒絕存取
沒有足夠的資源可完成作業。 (40002)
無法連線到記憶體提供者。 (46000)
儲存提供者無法連線到儲存子系統。 (46001)
備註
如果您多次呼叫此方法，可能會覆寫或遺失先前的要求。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |