estructura NTMS_LIBRARYINFORMATION (ntmsapi.h)

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La estructura NTMS_LIBRARYINFORMATION define las propiedades específicas de un objeto de biblioteca.

Sintaxis

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;

Miembros

LibraryType

Objeto de tipo de biblioteca. Puede ser uno de los siguientes valores.

Valor	Significado
NTMS_LIBRARYTYPE_ONLINE	Un elemento robótico que automatiza el montaje y desmontaje de medios en una o varias unidades.
NTMS_LIBRARYTYPE_STANDALONE	Una unidad independiente que se modela como una biblioteca con una unidad en RSM.
NTMS_LIBRARYTYPE_OFFLINE	Los medios que no están en una biblioteca están en la biblioteca sin conexión.
NTMS_LIBRARYTYPE_UNKNOWN	No se puede determinar el tipo de biblioteca.

CleanerSlot

Para cada biblioteca, representa la ranura que se asignó al cartucho más limpio. Si este miembro es NULL, no hay ninguna ranura más limpia definida para esta biblioteca.

CleanerSlotDefault

Representa la ranura más limpia predeterminada o preferida de una biblioteca. Si es NULL, no hay una ranura preferida.

LibrarySupportsDriveCleaning

Usado por unidades que requieren limpieza bajo control robótico. Si es TRUE, se habilitan las operaciones de limpieza automática de unidades.

BarCodeReaderInstalled

Devuelve TRUE si se instala un lector de código de barras en una biblioteca; de lo contrario, devuelve FALSE.

InventoryMethod

Método seleccionado por el usuario o predeterminado para realizar el inventario de esta biblioteca. (Este miembro es grabable). Puede ser uno de los siguientes valores.

Valor	Significado
NTMS_INVENTORY_FAST	Si la biblioteca tiene instalado un lector de código de barra, este valor hace que se realice un inventario de código de barras. Si la biblioteca no tiene un lector de código de barra, esta marca hace que se realice un inventario diferencial (se clasifican las ranuras que pasan de vacía a completa).
NTMS_INVENTORY_OMID	Un inventario completo implica montar cada lado en una biblioteca y leer la identificación en medios del medio. Este tipo de inventario puede llevar mucho tiempo para algunas unidades de biblioteca.
NTMS_INVENTORY_NONE	Una vez cerrada la puerta de biblioteca, no se realiza ningún inventario. Es posible que el inventario sea necesario si se produce un error en la comprobación de etiquetas de montaje.

dwCleanerUsesRemaining

Número de usos restantes en el limpiador de la biblioteca. Este miembro es cero si no hay ningún limpiador presente o si la biblioteca no admite la limpieza.

FirstDriveNumber

Número de la primera unidad de la biblioteca.

dwNumberOfDrives

Número de unidades de la biblioteca.

FirstSlotNumber

Número de la primera ranura de la biblioteca.

dwNumberOfSlots

Número de ranuras de la biblioteca.

FirstDoorNumber

Número de la primera puerta de acceso de la biblioteca.

dwNumberOfDoors

Número de puertas de acceso en la biblioteca.

FirstPortNumber

Número del primer puerto de inserción o expulsión de la biblioteca.

dwNumberOfPorts

Número de puertos de inserción y expulsión en la biblioteca.

FirstChangerNumber

Número del primer modificador de la biblioteca.

dwNumberOfChangers

Número de modificadores de la biblioteca.

dwNumberOfMedia

Número de medios en la biblioteca en línea o sin conexión.

dwNumberOfMediaTypes

Número de tipos de medios admitidos por la biblioteca.

dwNumberOfLibRequests

Número de solicitudes de biblioteca actuales.

Reserved

Reservado.

AutoRecovery

Si este miembro es TRUE, se realizará un inventario completo si se produce un error en un montaje. El error puede ser un error de coincidencia de hardware o etiqueta. Para las bibliotecas de CD de ATAPI, este parámetro no se puede deshabilitar. El valor predeterminado es TRUE. Los propietarios de bibliotecas grandes deben deshabilitar esta característica.

dwFlags

Este miembro puede ser uno o varios de los valores siguientes.

Valor	Significado
NTMS_LIBRARYFLAG_FIXEDOFFLINE	La biblioteca es una biblioteca sin conexión, no una biblioteca que no está presente.
NTMS_LIBRARYFLAG_CLEANERPRESENT	Un limpiador está presente en el cambiador.
NTMS_LIBRARYFLAG_IGNORECLEANERUSESREMAINING	El cartucho más limpio se usará hasta que ya no limpie la unidad, en lugar de realizar un seguimiento del número de limpiezas que quedan. No establezca esta marca directamente. Se establece o borra según el valor de dwCleanerUsesRemaining. Se establece si dwCleanerUsesRemaining está 0xFFFFFFFF y se borra en caso contrario.
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE	Trate los cartuchos con códigos de barras que tienen CLN como prefijo como cartuchos más limpios, en lugar de montarlos en la unidad para identificarlos.

Comentarios

En el caso de las bibliotecas sin conexión, solo se notifican LibraryType y dwNumberOfMedia . Se deben omitir todos los demás valores.

La estructura NTMS_LIBRARYINFORMATION se incluye en la estructura NTMS_OBJECTINFORMATION .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	ntmsapi.h

Consulte también

NTMS_OBJECTINFORMATION