MSFT_StorageJob 類別

表示記憶體作業。

下列語法是從 Managed 物件格式 (MOF) 程式代碼簡化。

記憶體作業代表記憶體子系統上長時間執行的作業。 這些作業可以透過下列其中一種方式起始:

  • 用戶可透過此MOF所定義的各種管理介面。
  • 由智慧型手機儲存子系統自動執行。

語法

class MSFT_StorageJob : MSFT_StorageObject
{
  String   Name;
  String   Description;
  Datetime ElapsedTime;
  UInt16   ErrorCode;
  String   ErrorDescription;
  UInt16   JobState;
  String   JobStatus;
  UInt16   LocalOrUtcTime;
  UInt16   OperationalStatus[];
  String   StatusDescriptions[];
  UInt16   PercentComplete;
  Datetime StartTime;
  Datetime TimeBeforeRemoval;
  Datetime TimeOfLastStateChange;
  Datetime TimeSubmitted;
  Boolean  DeleteOnCompletion;
  Boolean  IsBackgroundTask;
  UInt16   RecoveryAction;
  String   OtherRecoveryAction;
};

成員

MSFT_StorageJob 類別具有下列類型的成員:

方法

MSFT_StorageJob 類別具有這些方法。

方法 Description
GetExtendedStatus 擷取失敗記憶體作業的擴充狀態資訊。
RequestStateChange 要求作業的狀態變更為 RequestedState 參數中指定的值。

屬性

MSFT_StorageJob 類別具有這些屬性。

DeleteOnCompletion

數據類型: 布爾值

存取類型:唯讀

如果 為 TRUE,則會在短時間間隔之後自動刪除記憶體作業。

描述

數據類型: 字串

存取類型:唯讀

記憶體作業正在追蹤之作業的文字描述。

ElapsedTime

數據類型: Datetime

存取類型:唯讀

如果作業仍在執行中,這個屬性會指出它執行的時間長度。 如果作業完成,則為運行時間總計。

ErrorCode

數據類型: UInt16

存取類型:唯讀

如果此記憶體作業追蹤的作業失敗,提供者會將此屬性設定為叫用作業的方法所定義的錯誤碼。 如果此記憶體作業追蹤背景工作,錯誤碼可以設定為下列值對應中定義的任何有效記憶體管理錯誤碼。 如果沒有錯誤,此屬性必須設定為 Success。 這個屬性應該是 NULL ,直到作業完成為止。

ErrorDescription

數據類型: 字串

存取類型:唯讀

包含廠商錯誤描述的免費格式字串。

IsBackgroundTask

數據類型: 布爾值

存取類型:唯讀

限定符: 必要

如果 為 TRUE,則此儲存作業代表由儲存子系統起始的自動化背景工作。 針對所有使用者或管理起始的作業,此值應該設定為 FALSE

JobState

數據類型: UInt16

存取類型:唯讀

限定符: 必要

作業的狀態。

(2)

開始 (3)

執行 (4)

暫停 (5)

關閉 (6)

已完成 (7)

終止 (8)

終止 (9)

例外 狀況 (10)

服務 (11)

查詢擱 置 (12)

Microsoft Reserved (13..32767)

廠商保留 (32768..65535)

JobStatus

數據類型: 字串

存取類型:唯讀

表示作業狀態的自由格式字串。 主要狀態會反映在 OperationalStatus 屬性中。 JobStatus 提供其他實作特定詳細數據。

LocalOrUtcTime

數據類型: UInt16

存取類型:唯讀

限定符: ( “Local Time”、“UTC Time” ) 、 ValueMap (“1”、“2”)

指出 RunStartIntervalUntilTime 屬性中的時間值是否代表當地時間或 UTC 時間。 時間值會透過將此屬性設定為 UTC Time來同步處理全球。

名稱

數據類型: 字串

存取類型:唯讀

限定符: 必要

記憶體作業的系統定義名稱。

OperationalStatus

數據類型: UInt16 陣列

存取類型:唯讀

限定符: 必要

指出參與記憶體作業之每個儲存子系統的目前狀態。

意義
未知 的 0 作業狀態未知。
其他 1 廠商特定的 OperationalStatus 是在 OtherOperationalStatusDescription 屬性中指定。
確定 2 儲存子系統正在回應命令,且處於正常作業狀態。
降級 3 儲存子系統正在回應命令,但未以最佳作業狀態執行。
壓力 4 記憶體子系統正常運作,但需要注意。 例如,它可能會多載或被擷取。
預測性失敗 5 記憶體子系統運作正常,但未來可能會失敗。
錯誤 6 發生錯誤了。
無法復原的錯誤 7 發生無法復原的錯誤。
開始 8 記憶體子系統正在啟動。
停止 9 儲存子系統正在停止。
已停止 10 儲存子系統已以全新且有順序的方式停止或關閉。
在服務 11 中 正在設定、維護、清除或管理記憶體子系統。
無連絡人 12 記憶體提供者知道記憶體子系統,但從未能夠與其通訊。
遺失通訊 13 記憶體提供者知道記憶體子系統,過去已與其通訊,但目前無法與其通訊。
中止 14 記憶體子系統突然停止,而且可能需要設定或維護。
休眠 15 記憶體提供者可以連絡記憶體子系統,但記憶體子系統目前沒有作用中。
支援錯誤 16 中的實體 這個值表示儲存子系統相依的另一個裝置或連線可能需要注意。 它不一定表示記憶體子系統本身發生問題。
已完成 17 記憶體子系統已完成作業。 此值應該與 「確定」、「錯誤」或「降級」結合,視作業的結果而定。
電源模式 18 此值會保留供系統使用。
DMTF 保留 .. 18 和0x8000 (独占) 之間的值會保留給 DMTF。
廠商保留 0x8000。。 大於或等於0x8000的值會保留給廠商。

OtherRecoveryAction

數據類型: 字串

存取類型:唯讀

要針對未成功執行的工作採取廠商特定的復原動作。 只有在 RecoveryAction 設定為 Other 時,才應該設定這個屬性。

PercentComplete

數據類型: UInt16

存取類型:唯讀

限定符:必要、單位 (百分比)

要求此值時已完成之作業的百分比。

RecoveryAction

數據類型: UInt16

存取類型:唯讀

描述要針對未成功執行作業採取的復原動作。 下列其中一個值。

意義
未知 的 0 所需的復原動作未知。
其他 1 復原動作是在 OtherRecoveryAction 屬性中指定。
不要繼續 2 停止執行記憶體作業,並適當地更新其狀態。
繼續進行下一個作業 3 繼續進行佇列中的下一個作業。
重新執行作業 4 重新執行作業

StartTime

數據類型: Datetime

存取類型:唯讀

啟動作業的時間。

StatusDescriptions

數據類型: 字串 陣列

存取類型:唯讀

OperationalStatus 值的描述。 例如,如果 StoppingOperationalStatus 中的值, 則 StatusDescriptions 的對應數位元素可能會說明停止物件的原因。

TimeBeforeRemoval

數據類型: Datetime

存取類型:唯讀

作業在完成執行之後,會保留以秒為單位的時間量,也就是該執行中成功或失敗。 不論 DeleteOnCompletion 屬性的值為何,作業都必須持續存在一段時間。

TimeOfLastStateChange

數據類型: Datetime

存取類型:唯讀

上次變更作業狀態的時間。 如果作業的狀態尚未變更,而且此屬性沒有值,則必須將它設定為零。 如果要求狀態變更,但遭到拒絕或尚未處理,則此屬性的值不得更新。

TimeSubmitted

數據類型: Datetime

存取類型:唯讀

提交作業以供執行的時間。 所有零的值表示擁有項目無法報告日期和時間。 因此, ScheduledStartTimeStartTime 會回報為相對於要求其值的時間間隔。

規格需求

需求
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
命名空間 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

另請參閱

MSFT_StorageObject