SetNtmsMediaComplete, fonction (ntmsapi.h)

Article
02/29/2024

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

La fonction SetNtmsMediaComplete marque un morceau de média logique comme étant terminé.

Syntaxe

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

Paramètres

[in] hSession

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

[in] lpMediaId

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

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS au pool de médias 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 de médias 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	L’identificateur de média n’est pas valide.
ERROR_INVALID_MEDIA_POOL	Le pool de supports pour le média n’est pas valide.
ERROR_INVALID_PARAMETER	L’identificateur de média est manquant.
ERROR_INVALID_STATE	Le média n’est pas dans l’état alloué ou est actuellement monté.
ERROR_NOT_ENOUGH_MEMORY	Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS	La fonction a réussi.

Remarques

La fonction SetNtmsMediaComplete marque le support spécifié comme Terminé. Une application marque le support comme Terminé lorsque l’application ne va plus écrire dans le support. Le support complet ne peut pas être monté avec l’indicateur NTMS_MOUNT_WRITE.

La fonction SetNtmsMediaComplete est généralement utilisée lorsqu’une application atteint la fin du média. Les supports montés ou en cours d’utilisation ne peuvent pas être marqués comme étant complets.

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

Fonctions Media Services

MountNtmsMedia

Partager via