Msvm_CopyFileToGuestJob::RequestStateChange 方法
變更作業的狀態。
語法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
參數
-
RequestedState [in]
-
新狀態。 以下是可能的值:
-
開始 (2)
-
將狀態變更為 「執行中」。
-
暫停 (3)
-
暫時停止作業。 接著,用戶端就可以使用 'Start' 重新開機作業。 當暫停時,用戶端可能會進入「服務」狀態, (這是作業特定的) 。
-
終止 (4)
-
以正常方式停止作業、儲存資料、保留狀態,以及依序關閉所有基礎進程。
-
kill (5)
-
立即終止作業,不需要儲存資料或保留狀態。
-
服務 (6)
-
將作業放入廠商特定的服務狀態。 用戶端可能會重新開機作業。
-
DMTF 保留 (7..32767)
-
廠商保留 (32768..65535)
TimeoutPeriod [in]
逾時期間,指定用戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定逾時期間。 值為 0 或 Null 表示用戶端沒有轉換的時間需求。 如果此屬性不包含 0 或 Null ,且實作不支援此參數,則必須傳回傳回碼 4098 (使用逾時參數 不支援) 。
傳回值
這個方法會傳回下列其中一個值。
傳回碼/值 | Description |
---|---|
|
成功。 |
|
|
|
|
|
拒絕存取。 |
|
|
|
|
|
|
|
|
|
|
|
不支援 RequestedState 參數中指定的值。 |
|
|
|
|
|
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 8.1 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2012 R2 [僅限傳統型應用程式] |
命名空間 |
\\Root\Virtualization\V2 |
MOF |
|
DLL |
|