SwapNtmsMedia, fonction (ntmsapi.h)
[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 |
---|---|
|
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é. |
|
Aucune bibliothèque d’étiquettes multimédias ne reconnaît l’étiquette multimédia. |
|
La base de données est inaccessible ou endommagée. |
|
La base de données est pleine. |
|
Le handle de session est manquant ou n’est pas valide. |
|
Au moins l’un des ID multimédias n’est pas valide. |
|
Un ou plusieurs pools de supports pour le média logique ne sont pas valides. |
|
Au moins un identificateur de média est manquant. |
|
Un échec d’allocation s’est produit pendant le traitement. |
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour