Fonction DisableNtmsObject (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 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

Partager via