共用方式為


VDS_VOLUME_PROP2結構 (vds.h)

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

定義 磁碟區對象的屬性。 這個結構與 VDS_VOLUME_PROP 結構相同,不同之處在於它也會包含磁碟區 GUID。

語法

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_VF_PERMANENTLY_DISMOUNTED旗標會在VDS_VOLUME_PROP2結構的 ulFlags 成員中設定,而VDS_VS_OFFLINE磁碟區狀態值也會在此結構的狀態成員中設定。

針對 GPT 和動態磁碟區, pUniqueId 成員指向的唯一標識碼是全域唯一的。

對於抽取式媒體磁碟驅動器,磁碟區存在,而且即使裝置中沒有媒體,也有自己的唯一標識符。 如果磁碟區在卸除式媒體上格式化,該磁碟區有自己的唯一標識符。 如需詳細資訊,請參閱 支援記憶體類別驅動程式中的掛接管理員要求

唯一標識碼的格式可能會因不同類型的裝置和磁碟區而有所不同。 對於 MBR 磁碟上的基本磁碟區,唯一標識符是以磁碟簽章和磁碟分區位移為基礎。 因為磁碟簽章和磁碟分區位移是 DWORD 值,所以無法保證唯一標識碼在所有計算機上都是全域唯一的。

如果磁碟簽章變更,磁碟區的唯一標識符也會變更。 磁碟簽章變更通常是因為磁碟複製期間發生衝突。

請注意,唯一標識符與磁碟區 GUID 路徑不同。 若要尋找磁碟區的磁碟區 GUID 路徑,請使用 IVdsVolumeMF3::QueryVolumeGuidPathnames 方法。

規格需求

需求
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 vds.h

另請參閱

IVdsVolume2::GetProperties2

MOUNTDEV_UNIQUE_ID

VDS 結構

VDS_FILE_SYSTEM_TYPE

VDS_HEALTH

VDS_TRANSITION_STATE

VDS_VOLUME_FLAG

VDS_VOLUME_STATUS

VDS_VOLUME_TYPE