NTMS_LIBRARYINFORMATION structure (ntmsapi.h)
[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]
The NTMS_LIBRARYINFORMATION structure defines properties specific to a library object.
Syntax
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;
Members
LibraryType
Library type object. This can be one of the following values.
CleanerSlot
For each library, this represents the slot that was assigned to the cleaner cartridge. If this member is NULL, there is no cleaner slot defined for this library.
CleanerSlotDefault
Represents a libraries' default or preferred cleaner slot. If NULL, there is not a preferred slot.
LibrarySupportsDriveCleaning
Used by drives that require cleaning under robotics control. If TRUE, automatic drive cleaning operations are enabled.
BarCodeReaderInstalled
Returns TRUE if a bar code reader is installed in a library; otherwise returns FALSE.
InventoryMethod
Default or user-selected method for performing inventory of this library. (This member is writable.) This can be one of the following values.
dwCleanerUsesRemaining
Number of uses remaining on the cleaner in the library. This member is zero if no cleaner is present or if the library does not support cleaning.
FirstDriveNumber
Number of the first drive in the library.
dwNumberOfDrives
Number of drives in the library.
FirstSlotNumber
Number of the first slot in the library.
dwNumberOfSlots
Number of slots in the library.
FirstDoorNumber
Number of the first access door in the library.
dwNumberOfDoors
Number of access doors in the library.
FirstPortNumber
Number of the first insert/eject port in the library.
dwNumberOfPorts
Number of insert/eject ports in the library.
FirstChangerNumber
Number of the first changer in the library.
dwNumberOfChangers
Number of changers in the library.
dwNumberOfMedia
Number of media in the online or offline library.
dwNumberOfMediaTypes
Number of media types supported by the library.
dwNumberOfLibRequests
Number of current library requests.
Reserved
Reserved.
AutoRecovery
If this member is TRUE, a full inventory will be performed if a mount fails. The failure may be either hardware or label mismatch. For ATAPI CD libraries, this parameter cannot be disabled. The default is TRUE. Large library owners should disable this feature.
dwFlags
This member can be one or more of the following values.
Remarks
For offline libraries, only LibraryType and dwNumberOfMedia are reported. All other values should be ignored.
The NTMS_LIBRARYINFORMATION structure is included in the NTMS_OBJECTINFORMATION structure.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Header | ntmsapi.h |