NTMS_PARTITIONINFORMATIONA 結構 (ntmsapi.h)

  • 發行項

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

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

語法

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

成員

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