Fonction SetNtmsDeviceChangeDetection (ntmsapi.h)

  • Article

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

La fonction SetNtmsDeviceChangeDetection définit un ou plusieurs appareils cibles pour la détection des modifications.

Syntaxe

DWORD SetNtmsDeviceChangeDetection(
  [in] HANDLE      hSession,
  [in] HANDLE      DetectHandle,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

Paramètres

[in] hSession

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

[in] DetectHandle

Handle de détection des modifications d’appareil à partir de BeginNtmsDeviceChangeDetection, ou NULL pour un seul sondage.

[in] lpRequestId

Identificateur d’objet pour l’appareil cible. Ce paramètre peut être un ou plusieurs bibliothèques, types de média ou GUID multimédia physiques. Tous les GUID doivent être du même type.

[in] dwType

Type d’identificateurs d’objet spécifiés dans le paramètre lpObjectId . Ce paramètre peut être l’une des valeurs suivantes du type d’énumération NtmsObjectsTypes : NTMS_LIBRARY, NTMS_MEDIA_TYPE ou NTMS_PHYSICAL_MEDIA.

[in] dwCount

Nombre d’identificateurs d’objet dans lpObjectId.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_INVALID_HANDLE
 Le handle de session ou de détection n’est pas valide.
ERROR_INVALID_PARAMETER
 Le type d’objet n’est pas valide.
ERROR_INVALID_LIBRARY
 La bibliothèque spécifiée est introuvable.
ERROR_INVALID_MEDIA
 Le média ou le type spécifié est introuvable.
ERROR_SUCCESS
 La demande d’opérateur a été annulée.

Remarques

L’appareil peut être spécifié directement en transmettant des GUID de bibliothèque ou indirectement en transmettant des GUID de média physique ou de type multimédia. Lors de l’utilisation de la spécification indirecte, toutes les bibliothèques autonomes qui peuvent contenir le type de média ou de média sont détectées. Tous les appareils spécifiés continuent d’être détectés jusqu’à ce que le handle de détection des modifications d’appareil soit fermé à l’aide de la fonction EndNtmsDeviceChangeDetection .

Cette fonction peut également être utilisée pour interroger les médias modifiés dans les appareils spécifiés. Il est généralement utilisé par une interface utilisateur lors de l’ouverture d’un nœud feuille ou de l’implémentation d’une option d’actualisation.

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

BeginNtmsDeviceChangeDetection

Fonctions de détection des modifications

EndNtmsDeviceChangeDetection