Fonction DisableNtmsObject (ntmsapi.h)
[Le Gestionnaire de stockage amovible n’est plus disponible à partir de Windows 7 et Windows Server 2008 R2.]
La fonction DisableNtmsObject désactive l’objet RSM spécifié.
DWORD DisableNtmsObject(
[in] HANDLE hSession,
[in] DWORD dwType,
[in] LPNTMS_GUID lpObjectId
);
[in] hSession
Gérez la session retournée par la fonction OpenNtmsSession .
[in] dwType
Type d’objet RSM. Ce paramètre peut être l’une des valeurs suivantes du type d’énumération NtmsObjectsTypes .
Valeur | Signification |
---|---|
|
Lecteur |
|
Bibliothèque |
|
Support physique (bande, disque optique, CD ou cartouche magnétique) |
[in] lpObjectId
Identificateur unique de l’objet RSM.
Cette fonction retourne l’une des valeurs suivantes.
Valeur | Signification |
---|---|
|
NTMS_MODIFY_ACCESS à la bibliothèque contenant l’objet est refusé. D’autres erreurs de sécurité sont possibles, mais indiquent une erreur de sous-système de sécurité.
Windows XP : NTMS_CONTROL_ACCESS à la bibliothèque contenant l’objet est refusé. D’autres erreurs de sécurité sont possibles, mais indiquent une erreur de sous-système de sécurité. |
|
La base de données est inaccessible ou endommagée. |
|
Le handle de session est manquant ou n’est pas valide. |
|
Un ID d’objet est manquant ou le type d’objet n’est pas valide. (Le type d’objet n’est pas valide s’il n’est pas NTMS_LIBRARY, NTMS_DRIVE ou NTMS_PHYSICAL_MEDIA.) |
|
L’objet est déjà désactivé. |
|
L’ID de bibliothèque fait référence à une bibliothèque hors ligne qui ne peut pas être activée ou désactivée. |
|
L'objet n'est pas valide. |
|
La désactivation est mise en file d’attente. |
La fonction DisableNtmsObject met en file d’attente une commande disable pour l’objet spécifié. La fonction retourne correctement lorsque la commande est mise en file d’attente. Si RSM est occupé, la commande peut prendre un certain temps. Lorsque le support est désactivé, RSM rend tous les côtés du média et le média logique associé indisponibles. Toutes les requêtes adressées au média désactivé retournent des erreurs.
Pour supprimer un lecteur ou un changeur de média du service, le lecteur ou le changeur de média doivent d’abord être désactivés.
Tous les objets contenus par un objet désactivé sont également désactivés. Par exemple, la désactivation d’un élément multimédia physique désactive tous les côtés. Dans la mesure du possible, lorsqu’un lecteur est désactivé, le support du lecteur est supprimé et placé dans son emplacement.
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 |