Fonction IdentifyNtmsSlot (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 IdentifyNtmsSlot identifie le média dans l’emplacement spécifié dans une bibliothèque. La commande retourne une fois l’identification terminée.

Syntaxe

DWORD IdentifyNtmsSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpSlotId,
  [in] DWORD       dwOption
);

Paramètres

[in] hSession

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

[in] lpSlotId

Identificateur unique de l’objet d’emplacement à identifier.

[in] dwOption

Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
NTMS_DISMOUNT_DEFERRED	Laissez le média dans le lecteur une fois l’identification du média terminée, comme s’il avait été démonté avec l’option « différé ».
NTMS_DISMOUNT_IMMEDIATE	Démontez le média dans le lecteur une fois l’identification du média terminée.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	L’accès à un ou plusieurs objets RSM est refusé.
ERROR_INVALID_HANDLE	La valeur spécifiée dans le paramètre hSession n’est pas valide.
ERROR_INVALID_PARAMETER	L’ID d’emplacement ou dwOption n’est pas valide.
ERROR_SUCCESS	La fonction a réussi.

Remarques

Si l’emplacement est vide, la fonction retourne ERROR_SUCCESS, mais aucun nouvel enregistrement multimédia n’apparaît.

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

InventoryNtmsLibrary

Fonctions de contrôle de bibliothèque

Partager via