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 的值來設定或清除。 如果 dwCleanerUsesRemaining 是0xFFFFFFFF，則會設定，否則會加以清除。
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE	將 CLN 視為更簡潔的前置詞，而不是將它們掛接在磁碟驅動器中以識別它們。

備註

針對離線連結庫，只會報告 LibraryType 和 dwNumberOfMedia 。 應該忽略所有其他值。

NTMS_LIBRARYINFORMATION 結構包含在 NTMS_OBJECTINFORMATION 結構中。

規格需求

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

另請參閱

NTMS_OBJECTINFORMATION