Fonction MoveToNtmsMediaPool (ntmsapi.h)

Article
03/04/2024

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

La fonction MoveToNtmsMediaPool déplace le support spécifié de son pool de médias actuel vers le pool de médias spécifié.

Syntaxe

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

Paramètres

[in] hSession

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

[in] lpMediaId

Identificateur unique d’un élément multimédia physique.

[in] lpPoolId

Identificateur unique du pool multimédia de destination.

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 source ou au pool multimédia de destination est refusé. D’autres erreurs de sécurité sont également possibles, mais elles indiquent une erreur de sous-système de sécurité.
ERROR_BUSY	Au moins un côté du média est en cours d’utilisation ou actuellement indisponible.
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	Le pool de médias de destination n’est pas valide ; le pool de médias est inexistant ; ou le média du pool non reconnu ou d’importation peut uniquement être déplacé vers le pool gratuit.
ERROR_INVALID_MEDIA	Le média source ou le pool de médias sources implicites n’est pas valide.
ERROR_INVALID_PARAMETER	L’ID multimédia ou l’ID du pool de médias est manquant.
ERROR_MEDIA_INCOMPATIBLE	Le type de média de la source diffère du type de média du pool multimédia de destination.
ERROR_NOT_ENOUGH_MEMORY	Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS	La fonction a réussi.

Remarques

Le pool de destination spécifié dans la fonction MoveToNtmsMediaPool doit être du même type de média et disposer d’une sécurité compatible.

RSM écrit un identificateur sur le média avant de déplacer le média dans le pool multimédia gratuit.

Un support ayant une partition à l’état Terminé, Alloué ou Réservé ne peut pas être déplacé vers le pool multimédia gratuit. Un support peut être déplacé vers un pool d’importation uniquement si toutes les partitions du support sont à l’état Importer.

Windows Server 2003 : Si le pool gratuit est le pool source, NTMS_USE_ACCESS au pool gratuit et NTMS_CONTROL_ACCESS au pool de destination est requis. Sinon, NTMS_CONTROL_ACCESS est requis sur le pool source et le pool de destination. Si le pool gratuit est le pool de destination, NTMS_CONTROL_ACCESS au pool source et NTMS_USER_ACCESS au pool gratuit est requis. Sinon, 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

CreateNtmsMediaPool

Fonctions Media Services

Partager via