Fonction CleanNtmsDrive (ntmsapi.h)

  • Article

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

La fonction CleanNtmsDrive met en file d’attente une demande de nettoyage pour le lecteur spécifié pour le nettoyage.

Syntaxe

DWORD CleanNtmsDrive(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpDriveId
);

Paramètres

[in] hSession

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

[in] lpDriveId

Identificateur unique du lecteur à nettoyer.

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_DRIVE
 L’ID de lecteur n’est pas valide.
ERROR_INVALID_HANDLE
 Le handle de session est manquant ou n’est pas valide.
ERROR_INVALID_LIBRARY
 La bibliothèque du lecteur n’est pas valide.
ERROR_INVALID_PARAMETER
 L’ID de lecteur est manquant.
ERROR_NOT_ENOUGH_MEMORY
 Un échec d’allocation s’est produit pendant le traitement.
ERROR_RESOURCE_DISABLED
 Le lecteur ou la bibliothèque n’est pas activé.
ERROR_SUCCESS
 Le nettoyage a été mis en file d’attente.

Remarques

Si le lecteur que vous avez sélectionné dans la fonction CleanNtmsDrive est un lecteur autonome, celui-ci est marqué comme nettoyé et l’heure est notée dans la base de données RSM.

Les demandes de nettoyage en file d’attente sont supprimées lorsque le service est redémarré.

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

Fonctions de gestion plus propres

EjectNtmsCleaner

InjectNtmsCleaner

ReleaseNtmsCleanerSlot

ReserveNtmsCleanerSlot