Fonction ReserveNtmsCleanerSlot (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 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

Partager via