Méthode IQueryCancelAutoPlay::AllowAutoPlay (shobjidl.h)
Détermine s’il faut lire le média inséré par un utilisateur et, le cas échéant, en utilisant les restrictions.
Syntaxe
HRESULT AllowAutoPlay(
[in] LPCWSTR pszPath,
[in] DWORD dwContentType,
[in] LPCWSTR pszLabel,
[in] DWORD dwSerialNumber
);
Paramètres
[in] pszPath
Type : LPCWSTR
Lettre de lecteur au format D:\
[in] dwContentType
Type : DWORD
Type de contenu tel que spécifié par les indicateurs suivants.
ARCONTENT_AUTORUNINF (0x00000002)
Utilisez le fichier Autorun.inf. Il s’agit du comportement d’exécution automatique traditionnel.
ARCONTENT_AUDIOCD (0x00000004)
Exécution automatique des CD audio.
ARCONTENT_DVDMOVIE (0x00000008)
Exécution automatique des DVD.
ARCONTENT_BLANKCD (0x00000010)
Lecture automatique des CD-Rs vides et des CD-RW.
ARCONTENT_BLANKDVD (0x00000020)
Lecture automatique des DVD-Rs vides et des DVD-RAMs.
ARCONTENT_UNKNOWNCONTENT (0x00000040)
Exécution automatique si le média est mis en forme et que le contenu ne relève pas d’un type couvert par l’un des autres indicateurs.
ARCONTENT_AUTOPLAYPIX (0x00000080)
Lecture automatique si le contenu se compose de types de fichiers définis en tant qu’images, tels que des fichiers .bmp et .jpg.
ARCONTENT_AUTOPLAYMUSIC (0x00000100)
Lecture automatique si le contenu se compose de types de fichiers définis comme de la musique, tels que des fichiers MP3.
ARCONTENT_AUTOPLAYVIDEO (0x00000200)
Lecture automatique si le contenu se compose de types de fichiers définis comme des fichiers vidéo.
ARCONTENT_VCD (0x00000400)
Introduit dans Windows Vista. Lecture automatique des CD vidéo (VCD).
ARCONTENT_SVCD (0x00000800)
Introduit dans Windows Vista. Lecture automatique du média SUPER VIDEO CD (SVCD).
ARCONTENT_DVDAUDIO (0x00001000)
Introduit dans Windows Vista. Lecture automatique DVD-Audio média.
ARCONTENT_BLANKBD (0x00002000)
Lecture automatique d’un support DVD haute définition enregistrable vierge au format Disque™ Blu-ray (BD-R ou BD-RW). Remarque : Avant Windows 7, cette valeur était définie pour spécifier les médias non enregistrables au format HD DVD.
ARCONTENT_BLURAY (0x00004000)
Introduit dans Windows Vista. Lecture automatique d’un média DVD haute définition au format Disque™ Blu-ray.
ARCONTENT_CAMERASTORAGE (0x00008000)
Introduit dans Windows 8.
ARCONTENT_CUSTOMEVENT (0x00010000)
Introduit dans Windows 8.
ARCONTENT_NONE (0x00000000)
Introduit dans Windows Vista. Lecture automatique d’un média vide mais mis en forme.
ARCONTENT_MASK (0x0001FFFE)
Introduit dans Windows Vista. Masque qui indique des valeurs d’indicateur ARCONTENT valides pour les types de médias. Ce masque n’inclut pas les valeurs ARCONTENT_PHASE.
ARCONTENT_PHASE_UNKNOWN (0x00000000)
Introduit dans Windows Vista. La lecture automatique effectue une recherche dans le média. La phase de la recherche (presniffing, sniffing ou final) est inconnue.
ARCONTENT_PHASE_PRESNIFF (0x10000000)
Introduit dans Windows Vista. Le contenu du média est connu avant que le média ne soit recherché, en raison du type de média ; pour instance, les CD audio et les films DVD.
ARCONTENT_PHASE_SNIFFING (0x20000000)
Introduit dans Windows Vista. La lecture automatique effectue actuellement des recherches dans le média. Tous les résultats signalés au cours de cette phase doivent être considérés comme une liste partielle, car d’autres types de contenu peuvent encore être trouvés.
ARCONTENT_PHASE_FINAL (0x40000000)
Introduit dans Windows Vista. La lecture automatique a terminé la recherche dans le média. Les résultats signalés sont définitifs.
ARCONTENT_PHASE_MASK (0x70000000)
Introduit dans Windows Vista. Masque qui indique des valeurs ARCONTENT_PHASE valides.
[in] pszLabel
Type : LPCWSTR
Étiquette multimédia.
[in] dwSerialNumber
Type : DWORD
Numéro de série du média.
Valeur retournée
Type : HRESULT
Retourne S_OK pour autoriser l’exécution automatique ou S_FALSE à annuler l’exécution automatique.
Remarques
Les applications inscrivent un instance de l’interface IQueryCancelAutoPlay dans la table d’objets en cours d’exécution (ROT). Avant que l’interpréteur de commandes ne démarre l’exécution automatique ou la lecture automatique, lorsque l’utilisateur insère un nouveau média, il recherche dans le ROT un composant implémentant IQueryCancelAutoPlay. S’il en trouve une, l’interpréteur de commande appelle la méthode IQueryCancelAutoPlay::AllowAutoPlay de cette implémentation pour déterminer si elle doit continuer et en utilisant les restrictions.
Lors de la présentation du support, l’interpréteur de commandes recherche dans le ROT un composant implémentant IQueryCancelAutoPlay. Si un élément est trouvé, l’identificateur de classe (CLSID) du moniker de ce composant est extrait. La présence d’une inscription ROT informe l’interpréteur de commandes que le composant peut souhaiter annuler l’exécution automatique ou la lecture automatique. Pour confirmation, l’interpréteur de commandes doit également trouver une clé de Registre pour ce même CLSID à l’emplacement suivant :
HKEY_LOCAL_MACHINE SOFTWARE Microsoft Windows Current Version Explorer AutoplayHandlers CancelAutoplay CLSID The component's CLSIDCette valeur est ajoutée par l’application ou le matériel, généralement au moment de l’installation. Aucune valeur de données ne lui est attribuée.
Configuration requise
| 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 | shobjidl.h |
| DLL | Shell32.dll |