Fonction EnableNtmsObject (ntmsapi.h)

  • Article

[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