NTMS_PARTITIONINFORMATIONW結構 (ntmsapi.h)

[從 Windows 7 和 Windows Server 2008 R2 起，已不再提供卸除式儲存管理員 。]

NTMS_PARTITIONINFORMATION 結構會定義側邊物件特有的屬性。

語法

typedef struct _NTMS_PARTITIONINFORMATIONW {
  NTMS_GUID     PhysicalMedia;
  NTMS_GUID     LogicalMedia;
  DWORD         State;
  WORD          Side;
  DWORD         dwOmidLabelIdLength;
  BYTE          OmidLabelId[NTMS_OMIDLABELID_LENGTH];
  WCHAR         szOmidLabelType[NTMS_OMIDLABELTYPE_LENGTH];
  WCHAR         szOmidLabelInfo[NTMS_OMIDLABELINFO_LENGTH];
  DWORD         dwMountCount;
  DWORD         dwAllocateCount;
  LARGE_INTEGER Capacity;
} NTMS_PARTITIONINFORMATIONW;

成員

PhysicalMedia

包含此端之媒體的唯一實體媒體標識碼。

LogicalMedia

包含此端之邏輯媒體的唯一邏輯媒體標識碼 (LMID) 。 如果未配置側邊，則此參數為 NULL 。

State

側邊生命周期資訊。 這可以是下列其中一個值。

值	意義
NTMS_PARTSTATE_ALLOCATED	媒體已配置給應用程式。
NTMS_PARTSTATE_AVAILABLE	媒體可供配置。
NTMS_PARTSTATE_COMPLETE	媒體已完全寫入，並由應用程式標示為完成。
NTMS_PARTSTATE_DECOMMISIONED	媒體不適用於資料儲存區，因此無法再使用。
NTMS_PARTSTATE_INCOMPATIBLE	媒體已找到並標示為與磁碟驅動器不相容。
NTMS_PARTSTATE_FOREIGN	媒體位於無法辨識的集區中。
NTMS_PARTSTATE_IMPORT	媒體位於匯入集區中。
NTMS_PARTSTATE_UNPREPARED	媒體正在等候套用免費標籤。
NTMS_PARTSTATE_RESERVED	AllocateNtmsMedia 函式已保留側邊，並將 dwOption 參數設定為 NTMS_ALLOCATE_NEW。

Side

零相對值，表示這是多端媒體的哪一端。 對於單面媒體，例如磁帶，這個值一律為零。 若為雙面媒體一NTMS_PARITIONINFORMATION記錄，此屬性設定為零 - “A” 端，而第二筆NTMS_PARTITIONINFORMATION記錄則設定為 1 - “B” 端。

dwOmidLabelIdLength

媒體標識碼的標籤標識符字串長度。

OmidLabelId[NTMS_OMIDLABELID_LENGTH]

媒體標識碼的標籤標識碼唯一標識碼。

szOmidLabelType[NTMS_OMIDLABELTYPE_LENGTH]

媒體標識碼的標籤。

szOmidLabelInfo[NTMS_OMIDLABELINFO_LENGTH]

媒體標識碼的標籤資訊。

dwMountCount

此媒體已掛接到磁碟驅動器的次數。 當對象在資料庫中建立時，這會初始化為零。

dwAllocateCount

已配置此媒體的次數。

Capacity

此端可用的記憶體位元組數。

備註

NTMS_PARTITIONINFORMATION 結構包含在 NTMS_OBJECTINFORMATION 結構中。

注意

ntmsapi.h 標頭會將NTMS_PARTITIONINFORMATION定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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

另請參閱

NTMS_OBJECTINFORMATION