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	會話標識碼遺失或無效。
ERROR_INVALID_PARAMETER	連結庫標識碼遺失。
ERROR_LIBRARY_OFFLINE	連結庫標識碼會參考沒有門的離線連結庫。
ERROR_NOT_ENOUGH_MEMORY	處理期間發生配置失敗。
ERROR_RESOURCE_DISABLED	連結庫已停用。
ERROR_RESOURCE_NOT_PRESENT	連結庫沒有門。
ERROR_SUCCESS	門存取已排入佇列。

某些連結庫沒有方法可讓 RSM 以程式設計方式鎖定和解除鎖定其門門。具有這些連結庫之此函式的行為，與 RSM 可以解除鎖定和鎖定的連結庫的行為相同。