VDS_VOLUME_PROP2構造体 (vds.h)
[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。
ボリューム オブジェクトのプロパティを定義します。 この構造体は 、ボリューム GUID も含まれている点を除き、VDS_VOLUME_PROP構造体と同じです。
構文
typedef struct _VDS_VOLUME_PROP2 {
VDS_OBJECT_ID id;
VDS_VOLUME_TYPE type;
VDS_VOLUME_STATUS status;
VDS_HEALTH health;
VDS_TRANSITION_STATE TransitionState;
ULONGLONG ullSize;
ULONG ulFlags;
VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
ULONG cbUniqueId;
LPWSTR pwszName;
BYTE *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;
メンバー
id
ボリュームの GUID。
type
ボリュームの種類を指定する VDS_VOLUME_TYPE 列挙値。 ボリュームの種類は、シンプル、スパン、ストライプ (RAID-0)、ミラー化、またはパリティ付きストライプ (RAID-5) です。
status
ボリュームの状態を指定する VDS_VOLUME_STATUS 列挙値。
health
ボリューム の 正常性状態を指定するVDS_HEALTH列挙値。
TransitionState
ボリューム の 遷移状態を指定するVDS_TRANSITION_STATE列挙値。
ullSize
ボリュームのサイズ (バイト単位)。
ulFlags
ボリュームを記述 VDS_VOLUME_FLAG 列挙値のビットマスク。
RecommendedFileSystemType
ボリューム の 優先ファイル システムを指定するVDS_FILE_SYSTEM_TYPE列挙値。 VDS_FST_NTFS、VDS_FST_FAT、VDS_FST_FAT32、VDS_FST_UDF、VDS_FST_CDFS、VDS_FST_UNKNOWNのいずれかである必要があります。
cbUniqueId
pUniqueId メンバーが指すバイト配列の長さ。
pwszName
CreateFile 関数を使用してボリュームのハンドルを開くために使用された名前。 たとえば、\?\GLOBALROOT\Device\HarddiskVolume1 などです。
pUniqueId
ボリュームの一意識別子を含むバイト配列。
注釈
IVdsVolume2::GetProperties2 メソッドは、ボリューム オブジェクトのプロパティを報告するためにこの構造体を返します。
ボリュームがオフラインの場合、 VDS_VOLUME_PROP2 構造体の ulFlags メンバーに VDS_VF_PERMANENTLY_DISMOUNTED フラグが設定され、 VDS_VS_OFFLINE ボリュームの状態値もこの構造体の 状態 メンバーに設定されます。
GPT および動的ボリュームの場合、 pUniqueId メンバーが指す一意識別子はグローバルに一意です。
リムーバブル メディア ドライブの場合、ボリュームは存在し、デバイスにメディアがない場合でも独自の一意識別子を持ちます。 ボリュームがリムーバブル メディアでフォーマットされている場合、そのボリュームには独自の一意識別子があります。 詳細については、「 記憶域クラス ドライバーでのマウント マネージャー要求のサポート」を参照してください。
一意識別子の形式は、デバイスとボリュームの種類によって異なる場合があります。 MBR ディスク上のベーシック ボリュームの場合、一意の識別子はディスク署名とパーティション オフセットに基づきます。 ディスク署名とパーティション オフセットは DWORD 値であるため、一意の識別子がコンピューター間でグローバルに一意であるとは限りません。
ディスク署名が変更されると、ボリュームの一意識別子も変更されます。 ディスク署名の変更は、通常、ディスクの複製中に競合が発生した結果として発生します。
一意識別子はボリューム GUID パスと同じではないことに注意してください。 ボリュームのボリューム GUID パスを見つけるには、 IVdsVolumeMF3::QueryVolumeGuidPathnames メソッドを 使用します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| Header | vds.h |