Fonction DismountNtmsMedia (ntmsapi.h)

  • Article

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

La fonction DismountNtmsMedia met en file d’attente une commande pour déplacer le média spécifié dans un lecteur vers son stockage. Cette fonction doit être associée à la fonction MountNtmsMedia .

Syntaxe

DWORD DismountNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       dwCount,
  [in] DWORD       dwOptions
);

Paramètres

[in] hSession

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

[in] lpMediaId

Tableau d’au moins un support logique ou un côté.

[in] dwCount

Nombre d’identificateurs de média dans le paramètre lpMediaId .

[in] dwOptions

Options. Ce paramètre peut être la valeur suivante.

Valeur Signification
NTMS_DISMOUNT_DEFERRED
 Marque l’état du média comme Démontable et conserve le support dans le lecteur. Les demandes de montage suivantes sont satisfaites à l’aide de lecteurs démontés ou démontables. La valeur par défaut consiste à démonter immédiatement.
NTMS_DISMOUNT_IMMEDIATE
 Démontez immédiatement le lecteur.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS au pool multimédia ou à la bibliothèque qui contient le 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_DEVICE_NOT_AVAILABLE
 Une ou plusieurs ressources requises pour effectuer le démontage ne sont actuellement pas disponibles (probablement désactivées).
ERROR_INVALID_LIBRARY
 La bibliothèque qui contient le média n’est pas valide.
ERROR_INVALID_MEDIA
 Au moins un des médias spécifiés n’est pas valide.
ERROR_INVALID_STATE
 Un état inattendu du support ou de l’appareil s’est produit lors du démontage.
ERROR_MEDIA_OFFLINE
 Le média spécifié est hors connexion.
ERROR_MEDIA_NOT_AVAILABLE
 Une ou plusieurs ressources multimédias requises pour effectuer le montage ne sont actuellement pas disponibles (probablement désactivées).
ERROR_NOT_ENOUGH_MEMORY
 Un échec d’allocation de mémoire s’est produit pendant le traitement.
ERROR_SUCCESS
 Le démontage du support a été mis en file d’attente.
ERROR_TIMEOUT
 L’événement de délai d’attente a expiré pendant que l’application a tenté d’acquérir une ou plusieurs ressources.

Remarques

Une application doit utiliser la fonction DismountNtmsMedia pour libérer la ressource de lecteur une fois que l’application a utilisé le support spécifié. Les médias non mis en publication ne peuvent pas être utilisés par d’autres sessions RSM.

La fonction DismountNtmsMedia retourne dès que l’opération est mise en file d’attente avec RSM. L’application peut attendre que l’état latéral devienne inactif.

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