Fonction ReleaseNtmsCleanerSlot (ntmsapi.h)

Article
02/29/2024

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

La fonction ReleaseNtmsCleanerSlot supprime une réservation d’emplacement existante pour une cartouche de nettoyage. L’emplacement peut ensuite être utilisé pour les cartouches de données.

Syntaxe

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

Paramètres

[in] hSession

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

[in] lpLibrary

Identificateur unique de la bibliothèque pour libérer l’emplacement 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_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_NOT_CONNECTED	Impossible de se connecter au service RSM.
ERROR_NO_SLOT_RESERVED	Cette bibliothèque n’a aucun emplacement réservé à une cartouche plus propre.
ERROR_SLOT_FULL	La bibliothèque a un emplacement de cartouche propre réservé, mais l’emplacement contient une cartouche plus propre (l’emplacement doit être vide). Utilisez la fonction EjectNtmsCleaner pour éjecter une cartouche plus propre.
ERROR_SLOT_NOT_PRESENT	La bibliothèque a un emplacement de cartouche plus propre réservé, mais l’emplacement spécifié n’est actuellement pas installé dans la bibliothèque. Cette erreur peut se produire si au moins un magazine est manquant dans la bibliothèque.
ERROR_SUCCESS	La fonction a été mise en file d’attente avec succès.

Remarques

Pour que la fonction ReleaseNtmsCleanerSlot réussisse, l’emplacement doit être présent et vide. La bibliothèque doit également disposer d’un emplacement réservé au nettoyage.

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

CleanNtmsDrive

Fonctions de gestion plus propres

EjectNtmsCleaner

InjectNtmsCleaner

ReserveNtmsCleanerSlot

Partager via