Share via

Fonction DisableNtmsObject (ntmsapi.h)

  • Article

[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é.

Syntaxe

DWORD DisableNtmsObject(
  [in] HANDLE      hSession,
  [in] DWORD       dwType,
  [in] LPNTMS_GUID lpObjectId
);

Paramètres

[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
NTMS_DRIVE
 Lecteur
NTMS_LIBRARY
 Bibliothèque
NTMS_PHYSICAL_MEDIA
 Support physique (bande, disque optique, CD ou cartouche magnétique)

[in] lpObjectId

Identificateur unique de l’objet RSM.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_ACCESS_DENIED
 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é.
ERROR_DATABASE_FAILURE
 La base de données est inaccessible ou endommagée.
ERROR_INVALID_HANDLE
 Le handle de session est manquant ou n’est pas valide.
ERROR_INVALID_PARAMETER
 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.)
ERROR_INVALID_STATE
 L’objet est déjà désactivé.
ERROR_LIBRARY_OFFLINE
 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.
ERROR_OBJECT_NOT_FOUND
 L'objet n'est pas valide.
ERROR_SUCCESS
 La désactivation est mise en file d’attente.

Remarques

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.

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

EnableNtmsObject

Fonctions de gestion des objets