ChangeNtmsMediaType, fonction (ntmsapi.h)

Article
03/06/2024

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

La fonction ChangeNtmsMediaType déplace l’id de média cible spécifié vers le pool de médias cible spécifié et définit l’identificateur de type de média de LADD sur le type de média du pool de médias cible.

Syntaxe

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

Paramètres

[in] hSession

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

[in] lpMediaId

Identificateur unique du support physique à déplacer.

[in] lpPoolId

Identificateur unique du pool de supports à partir duquel le média doit être alloué.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS à l’ordinateur ou le pool de médias du média est refusé. D’autres erreurs de sécurité sont 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é.
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_POOL	L’ID du pool de médias n’est pas valide.
ERROR_INVALID_PARAMETER	Le pool multimédia ou l’ID de média sont manquants.
ERROR_NOT_ENOUGH_MEMORY	Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS	La fonction a réussi.

Remarques

La fonction ChangeNtmsMediaType utilise la même stratégie de déplacement de média que la fonction MoveToNtmsMediaPool (les médias non reconnus peuvent uniquement être déplacés vers le pool gratuit).

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

AddNtmsMediaType

DeleteNtmsMediaType

Fonctions Media Services

Partager via