Metodo IQueryCancelAutoPlay::AllowAutoPlay (shobjidl.h)

Articolo
03/15/2023

Determina se riprodurre supporti inseriti da un utente e, se necessario, usando le restrizioni.

Sintassi

HRESULT AllowAutoPlay(
  [in] LPCWSTR pszPath,
  [in] DWORD   dwContentType,
  [in] LPCWSTR pszLabel,
  [in] DWORD   dwSerialNumber
);

Parametri

[in] pszPath

Tipo: LPCWSTR

Lettera di unità nel formato D:\

[in] dwContentType

Tipo: DWORD

Tipo di contenuto come specificato dai flag seguenti.

ARCONTENT_AUTORUNINF (0x00000002)

Usare il file Autorun.inf. Si tratta del comportamento di esecuzione automatica tradizionale.

ARCONTENT_AUDIOCD (0x00000004)

Cd audio di esecuzione automatica.

ARCONTENT_DVDMOVIE (0x00000008)

Dvd di esecuzione automatica.

ARCONTENT_BLANKCD (0x00000010)

AutoPlay vuoto CD-Rs e CD-RWS.

ARCONTENT_BLANKDVD (0x00000020)

AutoPlay vuoto DVD-Rs e DVD-RAMS.

ARCONTENT_UNKNOWNCONTENT (0x00000040)

Eseguire automaticamente se il supporto è formattato e il contenuto non rientra in un tipo coperto da uno degli altri flag.

ARCONTENT_AUTOPLAYPIX (0x00000080)

AutoPlay se il contenuto è costituito da tipi di file definiti come immagini, ad esempio .bmp e .jpg file.

ARCONTENT_AUTOPLAYMUSIC (0x00000100)

AutoPlay se il contenuto è costituito da tipi di file definiti come musica, ad esempio file MP3.

ARCONTENT_AUTOPLAYVIDEO (0x00000200)

AutoPlay se il contenuto è costituito da tipi di file definiti come file video.

ARCONTENT_VCD (0x00000400)

Introdotto in Windows Vista. CD video di Riproduzione automatica (VCD).

ARCONTENT_SVCD (0x00000800)

Introdotto in Windows Vista. Supporto SVCD (AutoPlay Super Video CD).

ARCONTENT_DVDAUDIO (0x00001000)

Introdotto in Windows Vista. AutoPlay DVD-Audio supporti.

ARCONTENT_BLANKBD (0x00002000)

Supporto DVD con registrazione elevata di riproduzione automatica vuoto nel formato Blu-ray Disc™ (BD-R o BD-RW). Nota: prima di Windows 7, questo valore è stato definito per specificare supporti non registrabili nel formato HD-DVD.

ARCONTENT_BLURAY (0x00004000)

Introdotto in Windows Vista. Supporto DVD ad alta definizione di Riproduzione automatica nel formato Blu-ray Disc™.

ARCONTENT_CAMERASTORAGE (0x00008000)

Introdotta in Windows 8.

ARCONTENT_CUSTOMEVENT (0x00010000)

Introdotta in Windows 8.

ARCONTENT_NONE (0x00000000)

Introdotto in Windows Vista. Riproduzione automatica vuota ma formattata.

ARCONTENT_MASK (0x0001FFFE)

Introdotto in Windows Vista. Maschera che indica i valori del flag ARCONTENT validi per i tipi di supporti. Questa maschera non include valori ARCONTENT_PHASE.

ARCONTENT_PHASE_UNKNOWN (0x00000000)

Introdotto in Windows Vista. La riproduzione automatica esegue la ricerca dei supporti. La fase della ricerca (presniff, sniffing o finale) è sconosciuta.

ARCONTENT_PHASE_PRESNIFF (0x10000000)

Introdotto in Windows Vista. Il contenuto del supporto è noto prima che il supporto venga cercato, a causa del tipo di supporto; ad esempio, dischi audio e film DVD.

ARCONTENT_PHASE_SNIFFING (0x20000000)

Introdotto in Windows Vista. AutoPlay sta attualmente cercando i supporti. Tutti i risultati segnalati durante questa fase devono essere considerati un elenco parziale come più tipi di contenuto potrebbero essere ancora trovati.

ARCONTENT_PHASE_FINAL (0x40000000)

Introdotto in Windows Vista. AutoPlay ha completato la ricerca dei supporti. I risultati segnalati sono finali.

ARCONTENT_PHASE_MASK (0x70000000)

Introdotto in Windows Vista. Maschera che indica valori di ARCONTENT_PHASE validi.

[in] pszLabel

Tipo: LPCWSTR

Etichetta multimediale.

[in] dwSerialNumber

Tipo: DWORD

Numero di serie multimediale.

Valore restituito

Tipo: HRESULT

Restituisce S_OK per consentire l'esecuzione automatica o l'S_FALSE per annullare l'esecuzione automatica.

Commenti

Le applicazioni registrano un'istanza dell'interfaccia IQueryCancelAutoPlay nella tabella degli oggetti in esecuzione (ROT). Prima di avviare AutoRun o AutoPlay, quando l'utente inserisce nuovi supporti, controlla rot per un componente che implementa IQueryCancelAutoPlay. Se ne trova uno, shell chiama il metodo IQueryCancelAutoPlay::AllowAutoPlay per determinare se deve procedere e usare le restrizioni.

Dopo la presentazione dei supporti, Shell cerca rot per un componente che implementa IQueryCancelAutoPlay. Se viene trovato, viene estratto l'identificatore di classe (CLSID) del moniker del componente. La presenza di una registrazione ROT informa shell che il componente potrebbe voler annullare l'esecuzione automatica o AutoPlay. Per confermare, shell deve anche trovare una chiave del Registro di sistema per lo stesso CLSID nella posizione seguente:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            Current Version
               Explorer
                  AutoplayHandlers
                     CancelAutoplay
                        CLSID
                           The component's CLSID

Questo valore viene aggiunto dall'applicazione o dall'hardware, in genere in fase di installazione. Non viene assegnato un valore di dati.

Nota Il CLSID immesso come valore in questa chiave non deve essere racchiuso tra parentesi graffe.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl.h
DLL	Shell32.dll

Condividi tramite