VDS_HEALTH列舉 (vdshwprv.h)

發行項
03/13/2024

[從 Windows 8 和 Windows Server 2012 開始，虛擬磁碟服務 COM 介面會由 Windows 記憶體管理 API 取代。

定義 VDS 物件的健全狀況狀態值集。

Syntax

typedef enum _VDS_HEALTH {
  VDS_H_UNKNOWN = 0,
  VDS_H_HEALTHY = 1,
  VDS_H_REBUILDING = 2,
  VDS_H_STALE = 3,
  VDS_H_FAILING = 4,
  VDS_H_FAILING_REDUNDANCY = 5,
  VDS_H_FAILED_REDUNDANCY = 6,
  VDS_H_FAILED_REDUNDANCY_FAILING = 7,
  VDS_H_FAILED = 8,
  VDS_H_REPLACED = 9,
  VDS_H_PENDING_FAILURE = 10,
  VDS_H_DEGRADED = 11
} VDS_HEALTH;

常數


`VDS_H_UNKNOWN` 值： 0 無法判斷物件的健全狀況。
`VDS_H_HEALTHY` 值： 1 物件表示在線狀態。此健全狀態值表示物件可完全運作且正常運作，但並不表示物件可供使用。例如，如果對像是磁碟，磁碟就不會遺失、記錄和組態檔已同步處理，且磁碟沒有 I/O 錯誤。如果對像是 LUN 或磁碟區、所有 (鏡像、簡單、跨越和等量) 和數據行 (RAID-5) 皆可供使用，且沒有 I/O 錯誤。與此健康狀態相關聯的狀態值不得為 FAILED、UNKNOWN 或 MISSING。
`VDS_H_REBUILDING` 值： 2 鏡像 LUN 或磁碟區正在重新同步處理所有 plex，或與 RAID-5 同位 (等量分割) plex 為重新產生同位。
`VDS_H_STALE` 值： 3 物件組態已過時。狀態值不得為 FAILED 或 UNKNOWN。
`VDS_H_FAILING` 值： 4 物件失敗，但仍可運作。例如，具有失敗健康情況的 LUN 或磁碟區可能是產生偶爾會從中復原的輸入/輸出錯誤。狀態值不得為 FAILED 或 UNKNOWN。
`VDS_H_FAILING_REDUNDANCY` 值： 5 一或多個 plex 有錯誤，但物件正在運作，而且所有 plex 都已上線。此值僅適用於磁碟區和 LUN。
`VDS_H_FAILED_REDUNDANCY` 值： 6 一或多個叢集失敗，但至少有一個 plex 正在運作。此值僅適用於磁碟區和 LUN。
`VDS_H_FAILED_REDUNDANCY_FAILING` 值： 7 最後一個工作 plex 失敗。此值僅適用於磁碟區和 LUN。
`VDS_H_FAILED` 值： 8 物件失敗。具有失敗健康狀態的任何物件也有失敗的對象狀態。因此，狀態值必須是 FAILED。
`VDS_H_REPLACED` 值： 9 這個值是保留的。不要使用它。 Windows Server 2008、Windows Vista 和 Windows Server 2003：不支援此值。
`VDS_H_PENDING_FAILURE` 值： 10 物件不會失敗，但預期會根據物件屬性的分析而失敗。例如，磁碟可能會根據 S.M.A.R.T 數據設定為VDS_H_PENDING_FAILURE。狀態值不得為 FAILED 或 UNKNOWN。 Windows Server 2008、Windows Vista 和 Windows Server 2003：不支援此值。
`VDS_H_DEGRADED` 值： 11 物件尚未完全失敗，但發生失敗。如果對像是子系統對象，韌體可能會報告錯誤，或磁碟驅動器、控制器、埠或路徑子物件可能失敗或失敗。如果對像是控制器對象，韌體可能會報告錯誤，或者埠或路徑子物件可能失敗或失敗。如果對像是存放集區物件，一或多個磁碟驅動器可能失敗或失敗。狀態值不得為 UNKNOWN。 Windows Server 2008、Windows Vista 和 Windows Server 2003：不支援此值。

備註

健康情況列舉值會套用至 VDS 物件，如下表所示。 Y 表示值會套用至物件，而 N 表示該值不適用於物件。 Pack 物件不會報告健康狀態。

健全狀況列舉值	磁碟	Subsystem	控制器	磁碟機	LUN	LUN plex	儲存體集區	磁碟區	磁碟區 plex
VDS_H_UNKNOWN	Y	Y	Y	Y	Y	Y	Y	Y	Y
VDS_H_HEALTHY	Y	Y	Y	Y	Y	Y	Y	Y	Y
VDS_H_REBUILDING	N	N	N	N	Y	Y	否	Y	Y
VDS_H_STALE	N	N	N	N	N	N	N	Y	Y
VDS_H_FAILING	是	N	N	N	Y	Y	否	Y	Y
VDS_H_FAILING_REDUNDANCY	N	N	N	N	Y	Y	否	Y	Y
VDS_H_FAILED_REDUNDANCY	N	N	N	N	Y	Y	否	Y	Y
VDS_H_FAILED_REDUNDANCY_FAILING	N	N	N	N	Y	Y	否	Y	Y
VDS_H_FAILED	Y	Y	Y	Y	Y	Y	否	Y	Y
VDS_H_REPLACED	N	N	Y	Y	N	N	N	N	N
VDS_H_PENDING_FAILURE	N	N	N	是	N	N	N	N	N
VDS_H_DEGRADED	否	Y	Y	N	N	N	是	N	N

數據表中所列之每個物件的屬性結構包含 VDS_HEALTH列舉的值 做為成員。

注意未來 Windows 版本中可能會將其他常數新增至 VDS_HEALTH 列舉。基於這個理由，您的應用程式必須設計為正常處理無法辨識 的列舉 常數VDS_HEALTH。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	vdshwprv.h