IQueryCancelAutoPlay::AllowAutoPlay-Methode (shobjidl.h)
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 CLSIDDieser Wert wird von der Anwendung oder Hardware hinzugefügt, in der Regel zur Installationszeit. Ihr wird kein Datenwert zugewiesen.
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 |