Win32_Volume クラス - WMI Library

Win32_Volume クラスの説明

Win32_Volume クラスは、ハードディスクの記憶域の領域を表します。このクラスにより、フォーマット済み、未フォーマット、マウント済み、またはオフラインのローカル ボリュームが返されます。ボリュームは、FAT または NTFS などのファイル システムを使ってフォーマットされ、ドライブ文字が割り当てられていることもあります。単一のハード ディスクに複数のボリュームを作成したり、ボリュームに複数のディスクを作成したりもできます。The Win32_Volume クラスでは、ディスケット ドライブの管理はサポートされません。
WMI Providerは、MSVDS__PROVIDERです。

---

プロパティ リスト

Access

Data Type: uint16

Access Type: Read Only

Access はメディアが読み取り可能 (値 = 1) かどうか、書き込み可能 (値 = 2) かどうか、またはその両方 (値 = 3) かどうかを説明します。"不明" (0) および "ライト ワンス" (4) も定義できます。

Automount

Data Type: boolean

Access Type: Read Only

TRUE の場合、Automount プロパティにより、最初の I/O が発行されるときにボリュームがファイル システムに自動的にマウントされることが示されます。そうでない場合は、マウント メソッドで明示的にマウントするか、またはドライブ文字かマウント ポイントを追加することで明示的にマウントするまでマウントされません。

Availability

Data Type: uint16

Access Type: Read Only

デバイスの利用可能性と状態です。たとえば、Availability プロパティは、デバイスが実行中で通常の電力状態 (値 = 3) にあるか、警告 (4)、テスト中 (5)、低下 (10)、または省電力状態 (値 = 13-15 および 17) にあることを示します。省電力状態は次のように定義されています: 値 13 ("省電力 - 不明") は、デバイスが省電力モードになっていることは確かだが、省電力モードにおけるどの状態にあるかが不明であることを示します。値 14 ("省電力 - 低電力モード") は、デバイスが省電力状態になっているが機能しており、パフォーマンスは低下する場合があることを示します。値 15 ("省電力 - スタンバイ") は、デバイスが機能していないが、通常の電力での動作に 'すばやく' 移行できることを示します。値 17 ("省電力 - 警告") は、デバイスが警告状態になっているが、省電力モードでもあることを示します。

BlockSize

Data Type: uint64

Access Type: Read Only

この StorageExtent を形成するブロックのサイズ (バイト) です。可変ブロック サイズの場合は、最大ブロック サイズ (バイト) を指定する必要があります。ブロック サイズが不明、またはブロックの概念が無効な場合 (集合拡張、メモリ、LogicalDisk など)、1 を入力してください。

BootVolume

Data Type: boolean

Access Type: Read Only

BootVolume プロパティは、現在実行中のオペレーティング システム ファイルがボリュームに含まれているかどうかを示します。

Capacity

Data Type: uint64

Access Type: Read Only

Capacity プロパティにより、ボリュームのサイズ がバイト数で示されます。

Caption

Data Type: string

Access Type: Read Only

Caption プロパティは、オブジェクトを短いテキスト (1 行の文字列) で表した説明です。

Compressed

Data Type: boolean

Access Type: Read Only

TRUE の場合、ボリュームは DoubleSpace ボリュームのような単一の圧縮エンティティとして存在します。ファイルを基にした圧縮がサポートされる場合 (例: NTFS)、このプロパティは FALSE になります。

ConfigManagerErrorCode

Data Type: uint32

Access Type: Read Only

Win32 構成マネージャーのエラー コードを示します。次の値が返されます:
0 このデバイスは正常に動作しています。
1 このデバイスは正しく構成されていません。
2 このデバイスのドライバーを読み込めません。
3 このデバイスのドライバーは壊れているか、あるいはメモリまたは他のリソースが不足している状態でシステムが実行されている可能性があります。
4 このデバイスは正常に動作していません。ドライバーつまたはレジストリが壊れている可能性があります。
5 このデバイスのドライバーには Windows が管理できないリソースが必要です。
6 このデバイスのブート構成が他のデバイスと競合しています。
7 フィルター処理できません。
8 デバイスのドライバー ローダーが見つかりません。
9 このデバイスを制御するファームウェアからリソースが正しく報告されないため、このデバイスは正常に動作していません。
10 このデバイスを開始できません。
11 このデバイスはエラーで停止しました。
12 このデバイスで使用できる十分な空きリソースが見つかりません。
13 このデバイスのリソースを確認できません。
14 コンピューターを再起動するまでこのデバイスは正常に動作しません。
15 このデバイスは、再列挙に問題が発生している可能性があり、正常に動作していません。
16 このデバイスで使用される一部のリソースを認識できません。
17 このデバイスは不明なリソースの種類を要求しています。
18 このデバイスのドライバーを再インストールしてください。
19 レジストリが壊れている可能性があります。
20 VxD ローダーの使用に失敗しました。
21 システム エラー: このデバイスのドライバーを変更してみてください。うまくいかない場合はハードウェアのマニュアルを参照してください。このデバイスは削除されます。
22 このデバイスは無効になっています。
23 システム障害: このデバイスのドライバーを変更してみてください。うまくいかない場合はハードウェアのマニュアルを参照してください。
24 このデバイスは存在しないか、正常に動作していないか、または一部のドライバーがインストールされていません。
25 このデバイスはまだセットアップ処理中です。
26 このデバイスはまだセットアップ処理中です。
27 このデバイスに有効なログ構成がありません。
28 このデバイスのドライバーはインストールされていません。
29 このデバイスは、必要なリソースがデバイスのファームウェアから提供されなかったため無効になっています。
30 このデバイスは、他のデバイスが使用している割り込み要求 (IRQ) リソースを使用しています。
31 このデバイスは、このデバイスに必要なドライバーを読み込めないため正常に動作していません。

ConfigManagerUserConfig

Data Type: boolean

Access Type: Read Only

デバイスがユーザー定義の構成を使用しているかどうかを示します。

CreationClassName

Data Type: string

Access Type: Read Only

CreationClassName は、インスタンスの作成で使用されるクラス名、またはサブクラス名を示します。このクラスの他のキー プロパティと一緒に使用すると、このクラスおよびそのサブクラスのインスタンスすべてがこのプロパティによって一意に識別されます。

Description

Data Type: string

Access Type: Read Only

Description プロパティは、オブジェクトの説明を提供します。

DeviceID

Data Type: string

Access Type: Read Only

DeviceID プロパティにはシステムのボリュームを一意に識別している文字列が含まれます。

DirtyBitSet

Data Type: boolean

Access Type: Read Only

次の起動時に ChkDsk メソッドを実行するかどうか示します。

DriveLetter

Data Type: string

Access Type: Read Write

DriveLetter プロパティにより、ボリュームに割り当てられたドライブ文字が示されます。ドライブ文字のないボリュームのこのプロパティは NULL です。

DriveType

Data Type: uint32

Access Type: Read Only

DriveType プロパティはこの論理ディスクが表すディスク ドライブの種類に対応する数値を含みます。追加の値の詳細については、プラットフォーム SDK のドキュメントを参照してください。
例: CD-ROM ドライブは 5 を返します。

ErrorCleared

Data Type: boolean

Access Type: Read Only

ErrorCleared は LastErrorCode プロパティで報告されたエラーが現在解決されているかどうかを示すブール値のプロパティです。

ErrorDescription

Data Type: string

Access Type: Read Only

ErrorDescription は、LastErrorCode プロパティに記録されたエラーに関する詳細情報およびそれに対する修正アクションに関する情報を提供する自由形式の文字列です。

ErrorMethodology

Data Type: string

Access Type: Read Only

ErrorMethodology は、この拡張記憶域でサポートされているエラー検出およびエラー修正の種類を説明する自由形式の文字列です。

FileSystem

Data Type: string

Access Type: Read Only

FileSystem プロパティにより、論理ディスクのファイル システムが示されます。例: NTFS

FreeSpace

Data Type: uint64

Access Type: Read Only

FreeSpace プロパティにより、ボリュームの空き領域のバイト数が示されます。

IndexingEnabled

Data Type: boolean

Access Type: Read Write

コンテキストのインデックス付けが有効な場合、このプロパティは TRUE になります

InstallDate

Data Type: datetime

Access Type: Read Only

InstallDate プロパティは、オブジェクトがいつインストールされたかを示す datetime 値です。値がなくても、オブジェクトがインストールされていないことを示すわけではありません。

Label

Data Type: string

Access Type: Read Write

Label プロパティにより、論理ディスクのボリューム名が示されます。制約: 最長 32 文字です。ラベルのないボリュームのこのプロパティは NULL です。

LastErrorCode

Data Type: uint32

Access Type: Read Only

LastErrorCode には、その論理デバイスで最後に報告されたエラー コードが記録されています。

MaximumFileNameLength

Data Type: uint32

Access Type: Read Only

Windows ドライブにサポートされているファイル名コンポーネントの最大長です。ファイル名のコンポーネントとは、円記号ではさまれているファイル名の一部です。長い名前が指定のファイル システムでサポートされていることを示すのに値を使うことができます。たとえば、長い名前をサポートする FAT ファイル システムでは、以前の 8.3 インジケーターではない 255 値が格納されます。また、NTFS ファイル システムを使用するシステムでも長い名前はサポートされます。例: 255

Name

Data Type: string

Access Type: Read Only

Name プロパティは、オブジェクトを認識するためのラベルを定義します。サブクラスでは、Name プロパティは上書きされて Key プロパティになることがあります。

---

メソッド リスト

SetPowerState

SetPowerState は、論理デバイスに対して希望する電源状態と、デバイスをいつその状態にするかを定義します。電源状態は、1="通常の電力"、2="省電力 - 低電力モード"、3="省電力 - スタンバイ"、4="省電力 - その他"、5="電源サイクル" または 6="電源オフ" のいずれかの整数値を PowerState パラメーターに設定することで指定します。Time パラメーターには、(5 の "電源サイクル" を除くすべての状態変更について) 電源状態を設定するときを示す標準の日付時刻値または間隔値 (メソッド呼び出しが受信された時点からの経過時間) を指定します。PowerState パラメーターが 5 の "電源サイクル" の場合、Time パラメーターには、システムをもう一度電源オンにするときを指定します。電源オフは直ちに実行されます。SetPowerState は、成功した場合は 0 を返し、指定した PowerState および要求時間がサポートされていない場合は 1 を返し、その他のエラーが発生した場合は別の値を返します。サブクラスでは、メソッドに ValueMap 修飾子を使用して可能なリターン コードのセットを指定できる場合があります。また、サブクラスでは、ValueMap の内容を '翻訳' した文字列を Values 配列修飾子として指定できる場合があります。

Reset

論理デバイスのリセットを要求します。要求が正常に実行された場合、返される値は 0 で、要求がサポートされない場合は 1 です。また、エラーが発生した場合は他の値となります。

Chkdsk

このメソッドにより、ボリュームの chkdsk 操作が呼び出されます。このメソッドは、コンピューターの物理ディスクを表すこれらのボリューム インスタンスにのみ適用可能です。割り当て済み論理ドライブには適用できません。

ScheduleAutoChk

このメソッドは不良ビットが設定されている場合、次回の再起動のスケジュール chkdsk に使用されます。このメソッドはコンピューター内の物理ディスクを表す論理ディスクのこれらのボリューム インスタンスにのみ適用可能です。割り当て済み論理ドライブには適用できません。

ExcludeFromAutoChk

このメソッドは次回の再起動の chkdsk 操作からボリュームを除外するのに使用されます。除外されなかった場合、不良ビットがディスクに設定されていれば chkdsk はボリュームで実行されます。除外するボリュームへの呼び出しは累積ではありません。除外されたいくつかのボリュームに呼び出しがあった場合、既に除外とマークされた一覧に新しい一覧を追加する代わりに、ボリュームの新しい一覧が以前の一覧に上書きされます。このメソッドはコンピューター内の物理ディスクを表す論理ディスクのこれらのインスタンスにのみ適用可能です。割り当て済み論理ドライブには適用できません。

Format

このメソッドはボリュームのフォーマットに使用されます。

Defrag

このメソッドはボリュームを最適化するために使用されます。

DefragAnalysis

このメソッドは、ボリュームの最適化の分析を生成するために使用されます。

AddMountPoint

このメソッドは、ボリュームのマウント ポイント ディレクトリを追加するのに使用されます。このメソッドの結果は、このボリュームとパラメーター一覧に指定されているディレクトリを表す Win32_Directory インスタンスを関連付けている Win32_MountPoint クラスの作成です

Mount

このメソッドは、ボリュームをファイル システムにマウントするのに使用されます。

Dismount

このメソッドは、ファイル システムからボリュームのマウントを解除するのに使用されます。

---

WQL サンプル

SELECT * FROM Win32_Volume

VB6/VBS
SWbemServicesクラスのExecQueryメソッドからWQLを実行可能です。
Set PrcSet = Service.ExecQuery("SELECT * FROM Win32_Volume")

VB.Net
ObjectQueryクラスのQueryStringプロパティにWQLを設定し、ManagementObjectSearcherクラスのGetメソッドからWQLを実行可能です。
Searcher.Query.QueryString = "SELECT * FROM Win32_Volume"
PrcSrc = Searcher.Get

PowerShell
Get-WmiObjectコマンドレットのqueryオプションを指定しWQLを実行可能です。
Get-WmiObject -query "SELECT * FROM Win32_Volume"

---

このサイトの情報について

このコンテンツはWMIの各コンポーネントが持っているWin32_Volumeクラス情報を参照・抽出しリファレンスとして作成・提供しています。
参照したWMIの名前空間はroot/CIMV2、書き出し環境はWindows Server 2008 R2になります。

WMIの使い方(VB6, VBS, VBA, VB.NET, VC#, PowerShellを対象)に関してはWMI Stepも参考にしてみてください。(WMI初心者・入門編としてもおすすめです。) 各種言語を使用したWMIを使用するたたき台としてソーステンプレートも公開しています。プログラム/スクリプト作成時に役立てば…と思っています。

今後各WMI ClassをサポートしているOSの種類を掲載する予定です。
予定OS: Windows XP/Windows Vista/Windows 7/Windows Server 2003/Windows Server 2003 R2/Windows Server 2008/Windows Server 2008 R2

---