通过

InventoryNtmsLibrary 函数 (ntmsapi.h)

  • 项目

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

InventoryNtmsLibrary 函数将指定库的清单排队。 如果库正忙，RSM 会将 InventoryNtmsLibrary 排队并返回成功。

语法

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

参数

[in] hSession

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

[in] lpLibraryId

库对象的唯一标识符。

[in] dwAction

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

值 含义
NTMS_INVENTORY_OMID
 执行完整的媒体上清单。 每个介质的每一侧都必须装载到驱动器中。 这是一个耗时的过程。
NTMS_INVENTORY_FAST
 如果库安装了条形码读取器，则此标志会导致执行条码清单。 如果库没有条形码读取器，则此标志会导致 (槽) 分类时执行差异清单。
NTMS_INVENTORY_DEFAULT
 使用库对象中指定的 InventoryMethod (请参阅 NTMS_LIBRARYINFORMATION) 。
NTMS_INVENTORY_STOP
 停止指定库中的当前清单。

返回值

此函数返回以下值之一。

值 含义
ERROR_ACCESS_DENIED
 拒绝访问一个或多个 RSM 对象。
ERROR_DEVICE_NOT_AVAILABLE
 库当前未连接。
ERROR_INVALID_HANDLE
 hSession 参数中指定的值无效。
ERROR_INVALID_LIBRARY
 库是脱机库。
ERROR_INVALID_PARAMETER
 库 ID 或会话 ID 无效。
ERROR_NOT_CONNECTED
 无法连接到 RSM 服务。
ERROR_SUCCESS
 函数成功。

注解

无法列出不存在的库。

InventoryNtmsLibrary 函数标记库中当前包含介质的所有槽，以便进行分类/标识。 当标记所有媒体时， InventoryNtmsLibrary 函数返回。

要求

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

另请参阅

AccessNtmsLibraryDoor

库控制函数