Método IQueryCancelAutoPlay::AllowAutoPlay (shobjidl.h)

  • Artículo

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 CLSID
La aplicación o el hardware agregan este valor, normalmente en el momento de la instalación. No se le asigna un valor de datos.
Nota El CLSID especificado como un valor bajo esta clave no debe incluirse entre corchetes.
 

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