NTMS_PMIDINFORMATIONA 结构 (ntmsapi.h)

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

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

语法

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

成员

CurrentLibrary

包含媒体的库的唯一 ID。

MediaPool

介质分配到的媒体池的唯一 ID。

Location

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

LocationType

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

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
媒体准备从驱动器中删除时的状态。 驱动器状态“可卸除”也指示可以随时删除驱动器。
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