NTMS_LIBRARYINFORMATION struttura (ntmsapi.h)

Articolo
03/05/2024

[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La struttura NTMS_LIBRARYINFORMATION definisce le proprietà specifiche di un oggetto libreria.

Sintassi

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

Oggetto Tipo di libreria. Questo può essere uno dei valori seguenti.

Valore	Significato
NTMS_LIBRARYTYPE_ONLINE	Elemento robotico che automatizza il montaggio e la smontatura dei supporti in una o più unità.
NTMS_LIBRARYTYPE_STANDALONE	Unità autonoma modellata come libreria con un'unità in RSM.
NTMS_LIBRARYTYPE_OFFLINE	I supporti che non si trovano in una libreria si trovano nella libreria offline.
NTMS_LIBRARYTYPE_UNKNOWN	Impossibile determinare il tipo di libreria.

CleanerSlot

Per ogni libreria, questo rappresenta lo slot assegnato alla cartuccia più pulita. Se questo membro è NULL, non esiste uno slot più pulito definito per questa libreria.

CleanerSlotDefault

Rappresenta lo slot predefinito o preferito per le librerie. Se NULL, non esiste uno slot preferito.

LibrarySupportsDriveCleaning

Usato da unità che richiedono la pulizia sotto il controllo della robotica. Se TRUE, le operazioni di pulizia automatica dell'unità sono abilitate.

BarCodeReaderInstalled

Restituisce TRUE se un lettore di codice a barre è installato in una libreria; in caso contrario, restituisce FALSE.

InventoryMethod

Metodo predefinito o selezionato dall'utente per eseguire l'inventario di questa libreria. (Questo membro è scrivibile. Questo può essere uno dei valori seguenti.

Valore	Significato
NTMS_INVENTORY_FAST	Se la libreria dispone di un lettore di codice a barre installato, questo valore causa l'esecuzione di un inventario di codice a barre. Se la libreria non dispone di un lettore di codice a barre, questo flag causa l'esecuzione di un inventario differenziale (gli slot che passano da vuoti a completi sono classificati).
NTMS_INVENTORY_OMID	Un inventario completo prevede il montaggio di ogni lato in una libreria e la lettura dell'identificazione multimediale dal supporto. Questo tipo di inventario può richiedere molto tempo per alcune unità di libreria.
NTMS_INVENTORY_NONE	Dopo aver chiuso la porta della libreria, non viene eseguito alcun inventario. L'inventario potrebbe essere necessario se un controllo dell'etichetta di montaggio ha esito negativo.

dwCleanerUsesRemaining

Numero di usi rimanenti sul pulito nella libreria. Questo membro è zero se non è presente alcuna pulizia o se la libreria non supporta la pulizia.

FirstDriveNumber

Numero della prima unità nella libreria.

dwNumberOfDrives

Numero di unità nella libreria.

FirstSlotNumber

Numero del primo slot nella libreria.

dwNumberOfSlots

Numero di slot nella libreria.

FirstDoorNumber

Numero della prima porta di accesso nella libreria.

dwNumberOfDoors

Numero di porte di accesso nella libreria.

FirstPortNumber

Numero della prima porta di inserimento/inserimento nella libreria.

dwNumberOfPorts

Numero di porte di inserimento/inserimento nella libreria.

FirstChangerNumber

Numero del primo changer nella libreria.

dwNumberOfChangers

Numero di modifiche nella libreria.

dwNumberOfMedia

Numero di supporti nella libreria online o offline.

dwNumberOfMediaTypes

Numero di tipi multimediali supportati dalla libreria.

dwNumberOfLibRequests

Numero di richieste di libreria correnti.

Reserved

Riservato.

AutoRecovery

Se questo membro è TRUE, verrà eseguito un inventario completo se un montaggio ha esito negativo. L'errore potrebbe non corrispondere all'hardware o all'etichetta. Per le librerie CD ATAPI, questo parametro non può essere disabilitato. Il valore predefinito è TRUE. I proprietari di librerie di grandi dimensioni devono disabilitare questa funzionalità.

dwFlags

Questo membro può essere uno o più dei valori seguenti.

Valore	Significato
NTMS_LIBRARYFLAG_FIXEDOFFLINE	La libreria è una libreria offline, non una libreria non presente.
NTMS_LIBRARYFLAG_CLEANERPRESENT	Un pulitore è presente nel changer.
NTMS_LIBRARYFLAG_IGNORECLEANERUSESREMAINING	La cartuccia più pulita verrà usata fino a quando non pulisce più l'unità, invece di tenere traccia del numero di pulizia lasciato. Non impostare direttamente questo flag. Viene impostato o cancellato in base al valore dwCleanerUsesRemaining. È impostato se dwCleanerUsesRemaining è 0xFFFFFFFF e deselezionato in caso contrario.
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE	Trattare le cartucce con codice a barre con CLN come prefisso come cartucce più pulite, anziché montarle nell'unità per identificarle.

Commenti

Per le librerie offline, vengono segnalati solo LibraryType e dwNumberOfMedia . Tutti gli altri valori devono essere ignorati.

La struttura NTMS_LIBRARYINFORMATION è inclusa nella struttura NTMS_OBJECTINFORMATION .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	ntmsapi.h

Vedi anche

NTMS_OBJECTINFORMATION

Condividi tramite