DecommissionNtmsMedia, fonction (ntmsapi.h)

Article
03/04/2024

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

La fonction DecommissionNtmsMedia déplace un côté de l’état Disponible à l’état Désactivé.

Syntaxe

DWORD DecommissionNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId
);

Paramètres

[in] hSession

Handle à la session retournée par la fonction OpenNtmsSession .

[in] lpMediaId

Identificateur unique d’un côté d’un support physique.

Valeur retournée

Valeur	Signification
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS au pool de médias du média est refusé. D’autres erreurs de sécurité sont également possibles, mais elles indiquent une erreur de sous-système de sécurité. Windows XP : NTMS_MODIFY_ACCESS au pool de médias du média est refusé. D’autres erreurs de sécurité sont également 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_DATABASE_FULL	La base de données est pleine.
ERROR_INVALID_HANDLE	Le handle de session est manquant ou n’est pas valide.
ERROR_INVALID_MEDIA	L’identificateur de média n’est pas valide.
ERROR_INVALID_MEDIA_POOL	Le pool de supports multimédias n’est pas valide.
ERROR_INVALID_PARAMETER	L’identificateur de média est manquant.
ERROR_INVALID_STATE	Le média n’est pas à l’état Disponible.
ERROR_NOT_ENOUGH_MEMORY	Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS	La fonction a réussi.

Remarques

Le média mis hors service par la fonction DecommissionNtmsMedia est reconnu par RSM, mais le média désaffecté ne contient aucune donnée et n’est plus jamais utilisé.

Seul le média à l’état Disponible peut être désactivé. Pour plus d’informations, consultez Cycle de vie des médias.

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

AllocateNtmsMedia

Fonctions Media Services

Partager via