IQueryCancelAutoPlay::AllowAutoPlay-Methode (shobjidl.h)

  • Artikel

Bestimmt, ob Medien wiedergegeben werden sollen, die von einem Benutzer eingefügt wurden, und wenn ja, mit welchen Einschränkungen.

Syntax

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

Parameter

[in] pszPath

Typ: LPCWSTR

Der Laufwerkbuchstabe im Format D:\

[in] dwContentType

Art: DWORD

Der Inhaltstyp, der durch die folgenden Flags angegeben wird.

ARCONTENT_AUTORUNINF (0x00000002)

Verwenden Sie die Datei Autorun.inf. Dies ist das herkömmliche AutoRun-Verhalten.

ARCONTENT_AUDIOCD (0x00000004)

Audio-CDs automatisch ausführen.

ARCONTENT_DVDMOVIE (0x00000008)

DVDs automatisch ausführen.

ARCONTENT_BLANKCD (0x00000010)

Automatische Wiedergabe leerer CD-Rs und CD-RWs.

ARCONTENT_BLANKDVD (0x00000020)

Automatische Wiedergabe leerer DVD-Rs und DVD-RAMs.

ARCONTENT_UNKNOWNCONTENT (0x00000040)

AutoRun, wenn die Medien formatiert sind und der Inhalt nicht unter einen Typ fällt, der von einem der anderen Flags abgedeckt wird.

ARCONTENT_AUTOPLAYPIX (0x00000080)

Automatische Wiedergabe, wenn der Inhalt aus Dateitypen besteht, die als Bilder definiert sind, z. B. .bmp- und .jpg-Dateien.

ARCONTENT_AUTOPLAYMUSIC (0x00000100)

Automatische Wiedergabe, wenn der Inhalt aus Dateitypen besteht, die als Musik definiert sind, z. B. MP3-Dateien.

ARCONTENT_AUTOPLAYVIDEO (0x00000200)

Automatische Wiedergabe, wenn der Inhalt aus Dateitypen besteht, die als Videodateien definiert sind.

ARCONTENT_VCD (0x00000400)

In Windows Vista eingeführt. Video-CDs (VCDs) automatisch wiedergeben.

ARCONTENT_SVCD (0x00000800)

In Windows Vista eingeführt. SVCD-Medien (AutoPlay Super Video CD)

ARCONTENT_DVDAUDIO (0x00001000)

In Windows Vista eingeführt. Automatische Wiedergabe DVD-Audio Medien.

ARCONTENT_BLANKBD (0x00002000)

Automatische Wiedergabe leerer bespielbarer HD-DVD-Medien im Blu-ray-Disc-Format™ (BD-R oder BD-RW). Hinweis: Vor Windows 7 wurde dieser Wert definiert, um nicht beschriftbare Medien im HD DVD-Format anzugeben.

ARCONTENT_BLURAY (0x00004000)

In Windows Vista eingeführt. Automatische Wiedergabe von HD-DVD-Medien im Blu-ray-Disc-Format™.

ARCONTENT_CAMERASTORAGE (0x00008000)

In Windows 8 eingeführt.

ARCONTENT_CUSTOMEVENT (0x00010000)

In Windows 8 eingeführt.

ARCONTENT_NONE (0x00000000)

In Windows Vista eingeführt. Automatische Wiedergabe leerer, aber formatierter Medien.

ARCONTENT_MASK (0x0001FFFE)

In Windows Vista eingeführt. Eine Maske, die gültige ARCONTENT-Flagwerte für Medientypen angibt. Diese Maske enthält keine ARCONTENT_PHASE Werte.

ARCONTENT_PHASE_UNKNOWN (0x00000000)

In Windows Vista eingeführt. Die automatische Wiedergabe durchsucht die Medien. Die Phase der Suche (Presniff, Sniffing oder Final) ist unbekannt.

ARCONTENT_PHASE_PRESNIFF (0x10000000)

In Windows Vista eingeführt. Die Inhalte der Medien sind bekannt, bevor das Medium durchsucht wird, aufgrund des Medientyps; für instance, Audio-CDs und DVD-Filme.

ARCONTENT_PHASE_SNIFFING (0x20000000)

In Windows Vista eingeführt. Die automatische Wiedergabe durchsucht derzeit die Medien. Alle ergebnisse, die in dieser Phase gemeldet werden, sollten als teilliste betrachtet werden, da möglicherweise noch weitere Inhaltstypen gefunden werden.

ARCONTENT_PHASE_FINAL (0x40000000)

In Windows Vista eingeführt. Die automatische Wiedergabe hat die Suche nach den Medien abgeschlossen. Die gemeldeten Ergebnisse sind endgültig.

ARCONTENT_PHASE_MASK (0x70000000)

In Windows Vista eingeführt. Eine Maske, die gültige ARCONTENT_PHASE Werte angibt.

[in] pszLabel

Typ: LPCWSTR

Die Medienbezeichnung.

[in] dwSerialNumber

Art: DWORD

Die Medienseriennummer.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, damit AutoRun oder S_FALSE die Automatische Ausführung abbrechen können.

Hinweise

Anwendungen registrieren eine instance der IQueryCancelAutoPlay-Schnittstelle in der ausgeführten Objekttabelle (ROT). Bevor die Shell autoRun oder AutoPlay startet, überprüft der Benutzer beim Einfügen neuer Medien den ROT-Wert auf eine Komponente, die IQueryCancelAutoPlay implementiert. Wenn sie eine findet, ruft die Shell die IQueryCancelAutoPlay::AllowAutoPlay-Methode dieser Implementierung auf, um zu bestimmen, ob sie fortgesetzt werden soll, und welche Einschränkungen verwendet werden.

Nach der Präsentation von Medien durchsucht die Shell rot nach einer Komponente, die IQueryCancelAutoPlay implementiert. Wenn eine gefunden wird, wird der Klassenbezeichner (CLSID) des Monikers dieser Komponente extrahiert. Das Vorhandensein einer ROT-Registrierung informiert die Shell darüber, dass die Komponente autoRun oder AutoPlay abbrechen möchte. Zur Bestätigung muss die Shell auch einen Registrierungsschlüssel für dieselbe CLSID am folgenden Speicherort finden:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            Current Version
               Explorer
                  AutoplayHandlers
                     CancelAutoplay
                        CLSID
                           The component's CLSID
Dieser Wert wird von der Anwendung oder Hardware hinzugefügt, in der Regel zur Installationszeit. Ihr wird kein Datenwert zugewiesen.
Hinweis Die als Wert unter diesem Schlüssel eingegebene CLSID darf nicht in geschweifte Klammern eingeschlossen werden.
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl.h
DLL Shell32.dll