Fonction EnableNtmsObject (ntmsapi.h)

Article
08/25/2023

[Le Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]

La fonction EnableNtmsObject active l’objet spécifié.

Syntaxe

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

Paramètres

[in] hSession

Handle à 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 de disque 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ée. D’autres erreurs de sécurité sont possibles, mais elles indiquent une erreur de sous-système de sécurité. Windows XP : NTMS_CONTROL_ACCESS à la bibliothèque contenant l’objet est refusée. D’autres erreurs de sécurité sont 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_INVALID_HANDLE	Le handle de session est manquant ou n’est pas valide.
ERROR_INVALID_PARAMETER	L’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à activé.
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	L’activation est mise en file d’attente.

Notes

La fonction EnableNtmsObject met en file d’attente une commande disable avec RSM. Si RSM est occupé, l’exécution de la commande peut prendre un certain temps.

Spécifications


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

DisableNtmsObject

Fonctions de gestion des objets

Partager via