structure NTMS_LIBRARYINFORMATION (ntmsapi.h)

Article
08/25/2023

[Le Gestionnaire de stockage amovible n’est plus disponible à partir de Windows 7 et Windows Server 2008 R2.]

La structure NTMS_LIBRARYINFORMATION définit des propriétés spécifiques à un objet de bibliothèque.

Syntaxe

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;

Membres

LibraryType

Objet de type bibliothèque. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
NTMS_LIBRARYTYPE_ONLINE	Élément robotisé qui automatise le montage et le démontage d’un média dans un ou plusieurs lecteurs.
NTMS_LIBRARYTYPE_STANDALONE	Lecteur autonome modélisé en tant que bibliothèque avec un lecteur dans RSM.
NTMS_LIBRARYTYPE_OFFLINE	Le média qui n’est pas dans une bibliothèque se trouve dans la bibliothèque hors connexion.
NTMS_LIBRARYTYPE_UNKNOWN	Impossible de déterminer le type de bibliothèque.

CleanerSlot

Pour chaque bibliothèque, cela représente l’emplacement qui a été affecté à la cartouche plus propre. Si ce membre a la valeur NULL, aucun emplacement plus propre n’est défini pour cette bibliothèque.

CleanerSlotDefault

Représente l’emplacement propre par défaut ou préféré d’une bibliothèque. Si la valeur est NULL, il n’existe pas d’emplacement préféré.

LibrarySupportsDriveCleaning

Utilisé par les lecteurs qui nécessitent un nettoyage sous contrôle robotique. Si la valeur est TRUE, les opérations de nettoyage automatique du lecteur sont activées.

BarCodeReaderInstalled

Retourne TRUE si un lecteur de code-barres est installé dans une bibliothèque ; sinon, retourne LA VALEUR FALSE.

InventoryMethod

Méthode par défaut ou sélectionnée par l’utilisateur pour effectuer l’inventaire de cette bibliothèque. (Ce membre est accessible en écriture.) Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
NTMS_INVENTORY_FAST	Si un lecteur de code-barres est installé dans la bibliothèque, cette valeur entraîne l’exécution d’un inventaire de codes barres. Si la bibliothèque n’a pas de lecteur de code barre, cet indicateur entraîne l’exécution d’un inventaire différentiel (les emplacements qui sont passés de vide à complet sont classés).
NTMS_INVENTORY_OMID	Un inventaire complet implique de monter chaque côté dans une bibliothèque et de lire l’identification sur le support à partir du média. Ce type d’inventaire peut prendre beaucoup de temps pour certaines unités de bibliothèque.
NTMS_INVENTORY_NONE	Une fois la porte de la bibliothèque fermée, aucun inventaire n’est effectué. L’inventaire peut être requis si un montage case activée d’étiquette échoue.

dwCleanerUsesRemaining

Nombre d’utilisations restantes sur le nettoyeur dans la bibliothèque. Ce membre est égal à zéro si aucun nettoyeur n’est présent ou si la bibliothèque ne prend pas en charge le nettoyage.

FirstDriveNumber

Numéro du premier lecteur de la bibliothèque.

dwNumberOfDrives

Nombre de lecteurs dans la bibliothèque.

FirstSlotNumber

Numéro du premier emplacement de la bibliothèque.

dwNumberOfSlots

Nombre d’emplacements dans la bibliothèque.

FirstDoorNumber

Numéro de la première porte d’accès dans la bibliothèque.

dwNumberOfDoors

Nombre de portes d’accès dans la bibliothèque.

FirstPortNumber

Numéro du premier port d’insertion/éjection dans la bibliothèque.

dwNumberOfPorts

Nombre de ports d’insertion/d’éjection dans la bibliothèque.

FirstChangerNumber

Numéro du premier changeur dans la bibliothèque.

dwNumberOfChangers

Nombre de changeurs dans la bibliothèque.

dwNumberOfMedia

Nombre de médias dans la bibliothèque en ligne ou hors connexion.

dwNumberOfMediaTypes

Nombre de types de médias pris en charge par la bibliothèque.

dwNumberOfLibRequests

Nombre de demandes de bibliothèque actuelles.

Reserved

Réservé.

AutoRecovery

Si ce membre a la valeur TRUE, un inventaire complet est effectué en cas d’échec d’un montage. L’échec peut être une incompatibilité matérielle ou d’étiquette. Pour les bibliothèques DE CD ATAPI, ce paramètre ne peut pas être désactivé. La valeur par défaut est TRUE. Les propriétaires de bibliothèques volumineuses doivent désactiver cette fonctionnalité.

dwFlags

Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
NTMS_LIBRARYFLAG_FIXEDOFFLINE	La bibliothèque est une bibliothèque hors connexion, pas une bibliothèque qui n’est pas présente.
NTMS_LIBRARYFLAG_CLEANERPRESENT	Un nettoyeur est présent dans le changeur.
NTMS_LIBRARYFLAG_IGNORECLEANERUSESREMAINING	La cartouche plus propre sera utilisée jusqu’à ce qu’elle ne nettoie plus le lecteur, au lieu de suivre le nombre de nettoyages restants. Ne définissez pas cet indicateur directement. Il est défini ou effacé en fonction de la valeur de dwCleanerUsesRemaining. Il est défini si dwCleanerUsesRemaining est 0xFFFFFFFF et effacé dans le cas contraire.
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE	Traitez les cartouches avec code-barres qui ont CLN comme préfixe comme des cartouches plus propres, au lieu de les monter dans le lecteur pour les identifier.

Remarques

Pour les bibliothèques hors connexion, seuls LibraryType et dwNumberOfMedia sont signalés. Toutes les autres valeurs doivent être ignorées.

La structure NTMS_LIBRARYINFORMATION est incluse dans la structure NTMS_OBJECTINFORMATION .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	ntmsapi.h

Voir aussi

NTMS_OBJECTINFORMATION

Partager via