Fonction CleanNtmsDrive (ntmsapi.h)
[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 |
|---|---|
|
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é. |
|
La base de données est inaccessible ou endommagée. |
|
La base de données est pleine. |
|
L’ID de lecteur n’est pas valide. |
|
Le handle de session est manquant ou n’est pas valide. |
|
La bibliothèque du lecteur n’est pas valide. |
|
L’ID de lecteur est manquant. |
|
Un échec d’allocation s’est produit pendant le traitement. |
|
Le lecteur ou la bibliothèque n’est pas activé. |
|
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 |