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

媒体标识符的标签 ID 字符串的长度。

OmidLabelId[NTMS_OMIDLABELID_LENGTH]

媒体标识符的标签 ID 唯一标识符。

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