SwapNtmsMedia, 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 SwapNtmsMedia permute les côtés associés aux deux LMID spécifiés. Les LMID spécifiés doivent se trouver dans le même pool de supports.

Syntaxe

DWORD SwapNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId1,
  [in] LPNTMS_GUID lpMediaId2
);

Paramètres

[in] hSession

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

[in] lpMediaId1

Identificateur unique d’un élément de média logique (LMID).

[in] lpMediaId2

Identificateur unique d’un élément de média logique (LMID).

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS au pool de médias de l’un ou l’autre 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_BAD_FORMAT	Aucune bibliothèque d’étiquettes multimédias ne reconnaît l’étiquette multimédia.
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	Au moins l’un des ID multimédias n’est pas valide.
ERROR_INVALID_MEDIA_POOL	Un ou plusieurs pools de supports pour le média logique ne sont pas valides.
ERROR_INVALID_PARAMETER	Au moins un identificateur de média est manquant.
ERROR_NOT_ENOUGH_MEMORY	Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS	La fonction a réussi.

Remarques

La fonction SwapNtmsMedia est utilisée pour mettre à jour le média physique sans affecter l’application.

Le média des deux LMID ne doit pas être utilisé pour que cette fonction réussisse.

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