Fonction DismountNtmsMedia (ntmsapi.h)

Article
03/04/2024

[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

Partager via