通过

NTMS_LIBRARYINFORMATION 结构 (ntmsapi.h)

  • 项目

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

NTMS_LIBRARYINFORMATION 结构定义特定于库对象的属性。

语法

typedef struct _NTMS_LIBRARYINFORMATION {
  DWORD     LibraryType;
  NTMS_GUID CleanerSlot;
  NTMS_GUID CleanerSlotDefault;
  BOOL      LibrarySupportsDriveCleaning;
  BOOL      BarCodeReaderInstalled;
  DWORD     InventoryMethod;
  DWORD     dwCleanerUsesRemaining;
  DWORD     FirstDriveNumber;
  DWORD     dwNumberOfDrives;
  DWORD     FirstSlotNumber;
  DWORD     dwNumberOfSlots;
  DWORD     FirstDoorNumber;
  DWORD     dwNumberOfDoors;
  DWORD     FirstPortNumber;
  DWORD     dwNumberOfPorts;
  DWORD     FirstChangerNumber;
  DWORD     dwNumberOfChangers;
  DWORD     dwNumberOfMedia;
  DWORD     dwNumberOfMediaTypes;
  DWORD     dwNumberOfLibRequests;
  GUID      Reserved;
  BOOL      AutoRecovery;
  DWORD     dwFlags;
} NTMS_LIBRARYINFORMATION;

成员

LibraryType

库类型对象。 这可以是以下值之一。

值 含义
NTMS_LIBRARYTYPE_ONLINE
 一个机器人元素，用于自动将媒体装载和卸载到一个或多个驱动器中。
NTMS_LIBRARYTYPE_STANDALONE
 独立驱动器，在 RSM 中建模为具有一个驱动器的库。
NTMS_LIBRARYTYPE_OFFLINE
 不在库中的媒体位于脱机库中。
NTMS_LIBRARYTYPE_UNKNOWN
 无法确定库类型。

CleanerSlot

对于每个库，这表示分配给清洁器盒的插槽。 如果此成员为 NULL，则没有为此库定义清理器槽。

CleanerSlotDefault

表示库的默认或首选清理槽。 如果 为 NULL，则没有首选槽。

LibrarySupportsDriveCleaning

由需要在机器人控制下进行清洁的驱动器使用。 如果 为 TRUE，则启用自动驱动器清理操作。

BarCodeReaderInstalled

如果在库中安装了条形码读取器，则返回 TRUE ;否则返回 FALSE。

InventoryMethod

用于执行此库清单的默认或用户选择的方法。 (此成员可写。) 可以是以下值之一。

值 含义
NTMS_INVENTORY_FAST
 如果库安装了条形码读取器，则此值将导致执行条码清单。 如果库没有条形码读取器，则此标志会导致执行差异清单， (从空到满的槽) 分类。
NTMS_INVENTORY_OMID
 完整清单涉及将每一侧装载到库中，并从介质中读取媒体上的标识。 对于某些库单位来说，这种类型的清单可能非常耗时。
NTMS_INVENTORY_NONE
 关闭库门后，不执行任何清单。 如果装载标签检查失败，可能需要清单。

dwCleanerUsesRemaining

库中清理器上剩余的使用数。 如果不存在清理器或库不支持清理，则此成员为零。

FirstDriveNumber

库中第一个驱动器的编号。

dwNumberOfDrives

库中的驱动器数。

FirstSlotNumber

库中第一个槽的编号。

dwNumberOfSlots

库中的槽数。

FirstDoorNumber

库中第一个访问门的编号。

dwNumberOfDoors

库中的访问门数。

FirstPortNumber

库中第一个插入/弹出端口的编号。

dwNumberOfPorts

库中的插入/弹出端口数。

FirstChangerNumber

库中第一个更改器的编号。

dwNumberOfChangers

库中的变更器数。

dwNumberOfMedia

联机或脱机库中的媒体数。

dwNumberOfMediaTypes

库支持的媒体类型数。

dwNumberOfLibRequests

当前库请求数。

Reserved

保留。

AutoRecovery

如果此成员为 TRUE，则装载失败时将执行完整清单。 故障可能是硬件不匹配或标签不匹配。 对于 ATAPI CD 库，不能禁用此参数。 默认值为 TRUE。 大型库所有者应禁用此功能。

dwFlags

此成员可以是以下一个或多个值。

值 含义
NTMS_LIBRARYFLAG_FIXEDOFFLINE
 库是脱机库，而不是不存在的库。
NTMS_LIBRARYFLAG_CLEANERPRESENT
 更换器中存在清理器。
NTMS_LIBRARYFLAG_IGNORECLEANERUSESREMAINING
 清洁器墨盒将一直使用，直到它不再清洁驱动器，而不是跟踪剩余的清洁次数。 请勿直接设置此标志。 它根据 dwCleanerUsesRemaining 的值进行设置或清除。 如果 0xFFFFFFFF dwCleanerUsesRemaining ，则会设置该参数，否则将清除。
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE
 将带有 CLN 前缀的条形码墨盒视为更清洁的墨盒，而不是将其安装在驱动器中以识别它们。

注解

对于脱机库，仅报告 LibraryType 和 dwNumberOfMedia 。 应忽略所有其他值。

NTMS_LIBRARYINFORMATION 结构包含在 NTMS_OBJECTINFORMATION 结构中。

要求

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

另请参阅

NTMS_OBJECTINFORMATION