DeleteNtmsMedia, fonction (ntmsapi.h)

  • Article

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

La fonction DeleteNtmsMedia supprime une partie physique du média hors connexion de RSM en supprimant toutes les références au média spécifié de la base de données.

Syntaxe

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

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.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS à l’ordinateur ou 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 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 multimédia n’est pas valide.
ERROR_INVALID_MEDIA_POOL
 Le pool multimédia pour le média n’est pas valide.
ERROR_INVALID_PARAMETER
 L’identificateur multimédia est manquant.
ERROR_INVALID_STATE
 Le média n’est pas hors connexion.
ERROR_NOT_ENOUGH_MEMORY
 Un échec d’allocation s’est produit pendant le traitement.
ERROR_SUCCESS
 La fonction a réussi.

Remarques

Le média spécifié par la fonction DeleteNtmsMedia doit se trouver dans une bibliothèque hors connexion et ne pas avoir de côté dans les états Alloué, Terminé ou Réservé.

Vous pouvez utiliser DeleteNtmsMedia pour supprimer les médias perdus ou détruits.

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