Fonction DeallocateNtmsMedia (ntmsapi.h)

Article
02/29/2024

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

La fonction DeallocateNtmsMedia libère le côté associé au média logique spécifié.

Syntaxe

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

Paramètres

[in] hSession

Gérez la session retournée par la fonction OpenNtmsSession .

[in] lpMediaId

Identificateur unique du média logique (LMID).

dwOptions

Réservés au; doit être égal à zéro.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS au pool multimédia 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 multimédia 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	Le LMID n’est pas valide.
ERROR_INVALID_PARAMETER	L’ID du média ou du pool de médias est manquant.
ERROR_INVALID_PARTITION	Le côté LMID n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY	Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS	La fonction a réussi.

Remarques

Lorsqu’un support logique est libéré avec la fonction DeallocateNtmsMedia , RSM place le côté associé au média logique à l’état Média disponible ou désactivé. Le média logique est supprimé du système lorsque le média logique est libéré.

Les côtés sont mis hors service lors de la délocalisation si le côté a reçu le nombre maximal de fois spécifié dans le pool multimédia. Une fois que le média est à l’état Désactivé, il ne peut plus être alloué.

Windows Server 2003 : Si le média est retourné au pool gratuit, NTMS_USE_ACCESS au pool gratuit et NTMS_CONTROL_ACCESS au pool source est requis. Si le pool gratuit n’est pas le pool multimédia de destination, NTMS_CONTROL_ACCESS est requis sur les pools source et de destination.

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