NTMS_PMIDINFORMATIONW结构（ntmsapi.h）

[可移动存储管理器 自 Windows 7 和 Windows Server 2008 R2 起不再可用。

NTMS_PMIDINFORMATION 结构定义特定于物理媒体对象的属性。

语法

typedef struct _NTMS_PMIDINFORMATIONW {
  NTMS_GUID CurrentLibrary;
  NTMS_GUID MediaPool;
  NTMS_GUID Location;
  DWORD     LocationType;
  NTMS_GUID MediaType;
  NTMS_GUID HomeSlot;
  WCHAR     szBarCode[NTMS_BARCODE_LENGTH];
  DWORD     BarCodeState;
  WCHAR     szSequenceNumber[NTMS_SEQUENCE_LENGTH];
  DWORD     MediaState;
  DWORD     dwNumberOfPartitions;
  DWORD     dwMediaTypeCode;
  DWORD     dwDensityCode;
  NTMS_GUID MountedPartition;
} NTMS_PMIDINFORMATIONW;

成员

CurrentLibrary

包含媒体的库的唯一 ID。

MediaPool

向其分配媒体的媒体池的唯一 ID。

Location

媒体的物理位置对象的唯一 ID。

LocationType

物理介质的当前位置类型。 此成员的值可以设置为NTMS_STORAGESLOT、NTMS_DRIVE、NTMS_IEPORT。 （脱机媒体位于槽中）。

MediaType

媒体类型对象的唯一 ID。

HomeSlot

存储媒体的库存储槽的唯一 ID。

szBarCode[NTMS_BARCODE_LENGTH]

与一段物理介质的条形码标签上的条形码值匹配的字符串。

BarCodeState

条形码的当前状态。 这可以是以下值之一。

价值	意义
NTMS_BARCODESTATE_OK	媒体有一个条形码，可读。
NTMS_BARCODESTATE_UNREADABLE	媒体要么没有条形码，要么无法读取条形码。

szSequenceNumber[NTMS_SEQUENCE_LENGTH]

分配给指定介质的序号作为人工可读值，必须由媒体上的用户转录，以便该介质可以位于脱机库中。

MediaState

物理介质的当前状态。 这可以是以下值之一。

价值	意义
NTMS_MEDIASTATE_IDLE	介质位于库中的槽、驱动器卸载或脱机库中。
NTMS_MEDIASTATE_INUSE	成功向 RSM 发出操作请求后，媒体将标记为正在使用中。
NTMS_MEDIASTATE_LOADED	RSM 确定媒体可用于读取和写入时媒体的状态。
NTMS_MEDIASTATE_MOUNTED	将介质置于驱动器中时，一段物理介质的状态。
NTMS_MEDIASTATE_OP_ERROR	物理介质处于可恢复的错误状态。 无需操作员干预。
NTMS_MEDIASTATE_UNLOADED	当媒体已准备好从驱动器中删除时的状态。 驱动器状态“DISMOUNTABLE”也表示可以随时删除驱动器。
NTMS_MEDIASTATE_OPREQ	媒体正在等待操作员请求。

dwNumberOfPartitions

介质上的边数。

dwMediaTypeCode

SCSI 媒体类型代码。

dwDensityCode

SCSI 密度代码。

MountedPartition

当前装载的媒体侧的全局唯一 ID。

言论

NTMS_PMIDINFORMATION 结构包含在 NTMS_OBJECTINFORMATION 结构中。

注意

ntmsapi.h 标头将NTMS_PMIDINFORMATION定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求	价值
最低支持的客户端	Windows XP [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
标头	ntmsapi.h

另请参阅

NTMS_OBJECTINFORMATION