VDS_HEALTH列挙 (vdshwprv.h)

[アーティクル]
03/13/2024

[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられます。

VDS オブジェクトの正常性状態値のセットを定義します。

構文

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 またはボリュームがすべてのプレックスを再同期しているか、パリティ付きストライプ (RAID-5) プレックスがパリティを再生成します。
`VDS_H_STALE` 値: 3 オブジェクトの構成が古くなっています。状態の値は FAILED または UNKNOWN にすることはできません。
`VDS_H_FAILING` 値: 4 オブジェクトは失敗しますが、まだ動作しています。たとえば、正常性が失敗した LUN またはボリュームは、次のようになります。では、回復可能な入出力エラーが発生することがあります。状態の値は FAILED または UNKNOWN にすることはできません。
`VDS_H_FAILING_REDUNDANCY` 値: 5 1 つ以上のプレックスにエラーがありますが、オブジェクトは動作しており、すべてのプレックスがオンラインです。この値は、ボリュームと LUN に対してのみ有効です。
`VDS_H_FAILED_REDUNDANCY` 値: 6 1 つ以上のプレックスが失敗しましたが、少なくとも 1 つのプレックスが機能しています。この値は、ボリュームと LUN に対してのみ有効です。
`VDS_H_FAILED_REDUNDANCY_FAILING` 値: 7 最後の作業プレックスが失敗しています。この値は、ボリュームと 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 オブジェクトは完全には失敗していませんが、エラーが発生しています。オブジェクトがサブシステムオブジェクトの場合、ファームウェアがエラーを報告しているか、ドライブ、コントローラー、ポート、またはパスのサブオブジェクトが失敗したか、失敗している可能性があります。オブジェクトがコントローラーオブジェクトの場合、ファームウェアがエラーを報告しているか、ポートまたはパスのサブオブジェクトが失敗したか、失敗している可能性があります。オブジェクトが記憶域プールオブジェクトの場合は、1 つまたは複数のドライブが失敗したか、失敗している可能性があります。状態の値は UNKNOWN にすることはできません。 Windows Server 2008、Windows Vista、Windows Server 2003: この値はサポートされていません。

注釈

正常性列挙値は、次の表に示すように VDS オブジェクトに適用されます。 Y は値がオブジェクトに適用されることを示し、N は値がオブジェクトに適用されないことを示します。パックオブジェクトは正常性状態を報告しません。

正常性列挙値	ディスク	Subsystem	コントローラー	ドライブ	LUN	LUN プレックス	記憶域プール	ボリューム	ボリュームプレックス
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	×	×	×	×	Y	Y	×	Y	Y
VDS_H_STALE	×	×	×	×	×	×	×	Y	Y
VDS_H_FAILING	Y	×	×	×	Y	Y	×	Y	Y
VDS_H_FAILING_REDUNDANCY	×	×	×	×	Y	Y	×	Y	Y
VDS_H_FAILED_REDUNDANCY	×	×	×	×	Y	Y	×	Y	Y
VDS_H_FAILED_REDUNDANCY_FAILING	×	×	×	×	Y	Y	×	Y	Y
VDS_H_FAILED	Y	Y	Y	Y	Y	Y	×	Y	Y
VDS_H_REPLACED	×	×	Y	Y	×	×	×	×	×
VDS_H_PENDING_FAILURE	×	×	×	Y	×	×	×	×	×
VDS_H_DEGRADED	×	Y	Y	×	×	×	Y	×	×

表に示されている各オブジェクトのプロパティ構造には、メンバーとして VDS_HEALTH 列挙の値が含まれています。

メモ今後の Windows バージョンでは、 VDS_HEALTH 列挙に定数が追加される可能性があります。このため、認識されないVDS_HEALTH列挙定数を適切に処理するようにアプリケーションを設計する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	vdshwprv.h