共用方式為

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
 連結庫標識碼或會話標識碼無效。
ERROR_NOT_CONNECTED
 無法連線到 RSM 服務。
ERROR_SUCCESS
 函式成功。

備註

無法清查不存在的連結庫。

InventoryNtmsLibrary 函式會將目前包含媒體的所有位置標示為分類/識別連結庫中的媒體。 InventoryNtmsLibrary 函式會在標示所有媒體時傳回。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 ntmsapi.h
程式庫 Ntmsapi.lib
Dll Ntmsapi.dll

另請參閱

AccessNtmsLibraryDoor

連結庫控件函式