Fonction AccessNtmsLibraryDoor (ntmsapi.h)

Article
03/04/2024

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

La fonction AccessNtmsLibraryDoor déverrouille la porte de la bibliothèque spécifiée. Si la bibliothèque est occupée, RSM met en file d’attente la demande et retourne correctement.

Syntaxe

DWORD AccessNtmsLibraryDoor(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibraryId,
  [in] DWORD       dwAction
);

Paramètres

[in] hSession

Gérez la session retournée par la fonction OpenNtmsSession .

[in] lpLibraryId

Identificateur unique de l’objet de bibliothèque. Cette bibliothèque doit prendre en charge l’accès porte.

[in] dwAction

Action à effectuer. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
NTMS_INVENTORY_NONE	Une fois que l’utilisateur ferme la porte, aucun inventaire n’est effectué. Toutefois, si une case activée d’étiquette de montage échoue, un inventaire est effectué.
NTMS_INVENTORY_OMID	Une fois que l’utilisateur ferme la porte, un inventaire multimédia complet est effectué. Cela peut prendre du temps, car chaque côté de chaque support doit être monté.
NTMS_INVENTORY_FAST	Si un lecteur de codes barres est installé dans la bibliothèque, cet indicateur entraîne l’exécution de l’inventaire des 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 OMID sont vérifiées sur chaque support placé dans un emplacement vide pendant que la porte est ouverte.
NTMS_INVENTORY_DEFAULT	Utilisez l’inventaireMethod spécifié dans l’objet de bibliothèque (voir NTMS_LIBRARYINFORMATION).

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS à la bibliothèque est refusé. D’autres erreurs de sécurité sont également possibles, mais elles indiquent une erreur de sous-système de sécurité.
ERROR_DATABASE_FAILURE	La base de données est inaccessible ou endommagée.
ERROR_DATABASE_FULL	La base de données est pleine.
ERROR_INVALID_HANDLE	L’ID de session est manquant ou n’est pas valide.
ERROR_INVALID_PARAMETER	L’ID de bibliothèque est manquant.
ERROR_LIBRARY_OFFLINE	L’ID de bibliothèque fait référence à une bibliothèque hors connexion sans porte.
ERROR_NOT_ENOUGH_MEMORY	Un échec d’allocation s’est produit pendant le traitement.
ERROR_RESOURCE_DISABLED	La bibliothèque est désactivée.
ERROR_RESOURCE_NOT_PRESENT	La bibliothèque n’a pas de porte.
ERROR_SUCCESS	L’accès porte est mis en file d’attente.

Remarques

Certaines bibliothèques ne fournissent aucun moyen pour RSM de verrouiller et de déverrouiller par programmation leurs portes. Le comportement de cette fonction avec ces bibliothèques est identique à son comportement avec les bibliothèques que RSM peut déverrouiller et verrouiller.

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]
Plateforme cible	Windows
En-tête	ntmsapi.h
Bibliothèque	Ntmsapi.lib
DLL	Ntmsapi.dll

Voir aussi

EjectNtmsMedia

InjectNtmsMedia

Fonctions de contrôle de bibliothèque

Partager via