Fonction ReleaseNtmsCleanerSlot (ntmsapi.h)

  • Article

[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