Fonction DismountNtmsDrive (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 DismountNtmsDrive met en file d’attente une commande pour déplacer le média du lecteur spécifié vers son emplacement de stockage. Cette fonction doit être associée à la fonction MountNtmsMedia .

Syntaxe

DWORD DismountNtmsDrive(
  [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 d’un objet de lecteur.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	NTMS_MODIFY_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é. Windows XP : 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_DEVICE_NOT_AVAILABLE	Le lecteur ou la bibliothèque n’est pas activé.
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_INVALID_STATE	Le lecteur ne contient pas de média.
ERROR_NOT_ENOUGH_MEMORY	Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS	La fonction a réussi.

Remarques

Si le lecteur spécifié par la fonction DismountNtmsDrive est vide ou si le média est ouvert, une erreur est retournée. Sinon, le média est retourné à son emplacement.

Les demandes de démontage de lecteurs autonomes placent le lecteur dans l’état démontable et retournent la réussite.

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 contrôle de bibliothèque

Partager via