AccessNtmsLibraryDoor 函数 (ntmsapi.h)

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

AccessNtmsLibraryDoor 函数解锁指定库的门。如果库正忙，RSM 会将请求排队并成功返回。

语法

DWORD AccessNtmsLibraryDoor(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibraryId,
  [in] DWORD       dwAction
);

[in] hSession

OpenNtmsSession 函数返回的会话的句柄。

[in] lpLibraryId

库对象的唯一标识符。此库必须支持门访问。

[in] dwAction

要执行的操作。此参数的取值可为下列值之一：

值	含义
NTMS_INVENTORY_NONE	用户关闭门后，不会执行任何清单。但是，如果装载标签检查失败，将执行清单。
NTMS_INVENTORY_OMID	用户关闭门后，将执行完整的媒体上清单。这很耗时，因为必须装载每个介质的每一端。
NTMS_INVENTORY_FAST	如果库安装了条形码读取器，则此标志会导致执行条形码清单。如果库没有条形码读取器，则此标志会导致执行差异清单。门打开时，将检查放置在空槽中的每个介质上的 OMID。
NTMS_INVENTORY_DEFAULT	使用库对象中指定的 InventoryMethod (请参阅 NTMS_LIBRARYINFORMATION) 。

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝NTMS_CONTROL_ACCESS库。其他安全错误也可能存在，但它们表示存在安全子系统错误。
ERROR_DATABASE_FAILURE	数据库不可访问或已损坏。
ERROR_DATABASE_FULL	数据库已满。
ERROR_INVALID_HANDLE	会话 ID 缺失或无效。
ERROR_INVALID_PARAMETER	缺少库 ID。
ERROR_LIBRARY_OFFLINE	库 ID 引用没有门的脱机库。
ERROR_NOT_ENOUGH_MEMORY	处理期间发生分配失败。
ERROR_RESOURCE_DISABLED	库已禁用。
ERROR_RESOURCE_NOT_PRESENT	库没有门。
ERROR_SUCCESS	门访问已排队。

某些库不提供 RSM 以编程方式锁定和解锁其门的方法。具有这些库的此函数的行为与 RSM 可以解锁和锁定的库的行为相同。