Fonction AccessNtmsLibraryDoor (ntmsapi.h)

  • Article

[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