Fonction ReserveNtmsCleanerSlot (ntmsapi.h)

  • Article

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

La fonction ReserveNtmsCleanerSlot réserve un emplacement unique dans une unité de bibliothèque pour une cartouche de nettoyage de lecteur.

Syntaxe

DWORD ReserveNtmsCleanerSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibrary,
  [in] LPNTMS_GUID lpSlot
);

Paramètres

[in] hSession

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

[in] lpLibrary

Identificateur unique de la bibliothèque pour réserver l’emplacement plus propre.

[in] lpSlot

Identificateur unique de l’emplacement qui doit être réservé à une cartouche plus propre.

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_ALREADY_RESERVED
 Cet emplacement ou un autre emplacement de la bibliothèque a déjà été réservé au nettoyage. Pour modifier l’emplacement de la cartouche plus propre, l’emplacement nettoyeur actuellement réservé doit être libéré en premier, à l’aide de la fonction ReleaseNtmsCleanerSlot .
ERROR_DEVICE_NOT_AVAILABLE
 La bibliothèque n’est actuellement pas connectée.
ERROR_INVALID_HANDLE
 La valeur spécifiée dans le paramètre hSession n’est pas valide.
ERROR_INVALID_SLOT
 Impossible de récupérer la définition d’emplacement de la base de données.
ERROR_NOT_CONNECTED
 Impossible de se connecter au service RSM.
ERROR_SLOT_FULL
 Aucun emplacement de nettoyage n’est réservé. L’emplacement spécifié contient un média. La réservation ne peut être effectuée que sur un emplacement vide.
ERROR_SLOT_NOT_PRESENT
 Aucun emplacement de nettoyage n’est réservé. L’emplacement spécifié n’est actuellement pas installé dans la bibliothèque. Cette erreur se produit si au moins un chargeur de cartouche est manquant dans la bibliothèque.
ERROR_SUCCESS
 La fonction a été mise en file d’attente avec succès.

Notes

L’emplacement réservé avec la fonction ReserveNtmsCleanerSlot doit être présent et vide. La bibliothèque ne doit pas déjà disposer d’un emplacement réservé à une cartouche plus propre.

Spécifications

   
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

CleanNtmsDrive

Fonctions de gestion plus propres

EjectNtmsCleaner

InjectNtmsCleaner

ReleaseNtmsCleanerSlot