Método IQueryCancelAutoPlay::AllowAutoPlay (shobjidl.h)
Determina si se van a reproducir elementos multimedia insertados por un usuario y, si es así, con qué restricciones.
Sintaxis
HRESULT AllowAutoPlay(
[in] LPCWSTR pszPath,
[in] DWORD dwContentType,
[in] LPCWSTR pszLabel,
[in] DWORD dwSerialNumber
);
Parámetros
[in] pszPath
Tipo: LPCWSTR
La letra de unidad con el formato D:\
[in] dwContentType
Tipo: DWORD
Tipo de contenido especificado por las marcas siguientes.
ARCONTENT_AUTORUNINF (0x00000002)
Use el archivo Autorun.inf. Este es el comportamiento tradicional de autoejecutar.
ARCONTENT_AUDIOCD (0x00000004)
Ejecutar autoejecutar cds de audio.
ARCONTENT_DVDMOVIE (0x00000008)
Ejecución automática de DVDs.
ARCONTENT_BLANKCD (0x00000010)
Reproducción automática en blanco CD-Rs y CD-RW.
ARCONTENT_BLANKDVD (0x00000020)
Reproducción automática en blanco DVD-Rs y RAM de DVD.
ARCONTENT_UNKNOWNCONTENT (0x00000040)
Ejecutar automáticamente si el medio tiene formato y el contenido no está bajo un tipo cubierto por una de las otras marcas.
ARCONTENT_AUTOPLAYPIX (0x00000080)
Reproducción automática si el contenido consta de tipos de archivo definidos como imágenes, como archivos .bmp y .jpg.
ARCONTENT_AUTOPLAYMUSIC (0x00000100)
Reproducción automática si el contenido consta de tipos de archivo definidos como música, como archivos MP3.
ARCONTENT_AUTOPLAYVIDEO (0x00000200)
Reproducción automática si el contenido consta de tipos de archivo definidos como archivos de vídeo.
ARCONTENT_VCD (0x00000400)
Introducido en Windows Vista. Reproducción automática de los DISCOS de vídeo (VCD).
ARCONTENT_SVCD (0x00000800)
Introducido en Windows Vista. Contenido multimedia de Super Video CD (SVCD) de Reproducción automática.
ARCONTENT_DVDAUDIO (0x00001000)
Introducido en Windows Vista. Reproducción automática DVD-Audio multimedia.
ARCONTENT_BLANKBD (0x00002000)
Reproducción automática en blanco multimedia dvd de alta definición grabable en el formato Blu-ray Disc™ (BD-R o BD-RW). Nota: Antes de Windows 7, este valor se definió para especificar medios no grabables en el formato HD DVD.
ARCONTENT_BLURAY (0x00004000)
Introducido en Windows Vista. Reproducción automática de medios dvd de alta definición en el formato Blu-ray Disc™.
ARCONTENT_CAMERASTORAGE (0x00008000)
Introducido en Windows 8.
ARCONTENT_CUSTOMEVENT (0x00010000)
Introducido en Windows 8.
ARCONTENT_NONE (0x00000000)
Introducido en Windows Vista. Reproducción automática vacía pero con formato multimedia.
ARCONTENT_MASK (0x0001FFFE)
Introducido en Windows Vista. Máscara que denota valores de marca ARCONTENT válidos para los tipos de medios. Esta máscara no incluye ARCONTENT_PHASE valores.
ARCONTENT_PHASE_UNKNOWN (0x00000000)
Introducido en Windows Vista. Reproducción automática está buscando en los medios. Se desconoce la fase de la búsqueda (examen previo, examen o final).
ARCONTENT_PHASE_PRESNIFF (0x10000000)
Introducido en Windows Vista. El contenido de los medios se conoce antes de que se busque el medio, debido al tipo de medio; por ejemplo, CDs de audio y películas de DVD.
ARCONTENT_PHASE_SNIFFING (0x20000000)
Introducido en Windows Vista. Reproducción automática está buscando actualmente en los medios. Los resultados notificados durante esta fase deben considerarse una lista parcial, ya que es posible que todavía se encuentren más tipos de contenido.
ARCONTENT_PHASE_FINAL (0x40000000)
Introducido en Windows Vista. Reproducción automática ha terminado de buscar en los medios. Los resultados notificados son finales.
ARCONTENT_PHASE_MASK (0x70000000)
Introducido en Windows Vista. Máscara que denota valores de ARCONTENT_PHASE válidos.
[in] pszLabel
Tipo: LPCWSTR
Etiqueta multimedia.
[in] dwSerialNumber
Tipo: DWORD
Número de serie multimedia.
Valor devuelto
Tipo: HRESULT
Devuelve S_OK para permitir que autoejecutar o S_FALSE cancelar la ejecución automática.
Comentarios
Las aplicaciones registran una instancia de la interfaz IQueryCancelAutoPlay en la tabla de objetos en ejecución (ROT). Antes de que shell inicie AutoRun o AutoPlay, cuando el usuario inserte nuevos medios, comprueba el ROT de un componente que implementa IQueryCancelAutoPlay. Si encuentra una, el Shell llama al método IQueryCancelAutoPlay::AllowAutoPlay de esa implementación para determinar si debe continuar y usar qué restricciones.
Tras la presentación de medios, el Shell busca en rot un componente que implemente IQueryCancelAutoPlay. Si se encuentra uno, se extrae el identificador de clase (CLSID) del moniker de ese componente. La presencia de un registro ROT informa al Shell de que el componente podría querer cancelar autoejecutar o reproducir automáticamente. Para confirmarlo, el Shell también debe encontrar una clave del Registro para ese mismo CLSID en la siguiente ubicación:
HKEY_LOCAL_MACHINE SOFTWARE Microsoft Windows Current Version Explorer AutoplayHandlers CancelAutoplay CLSID The component's CLSIDLa aplicación o el hardware agregan este valor, normalmente en el momento de la instalación. No se le asigna un valor de datos.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl.h |
| Archivo DLL | Shell32.dll |