IPortableDevice::Cancel-Methode (portabledeviceapi.h)

Die Cancel-Methode bricht einen ausstehenden Vorgang für diese Schnittstelle ab.

Syntax

HRESULT Cancel();

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich abgebrochen.

Hinweise

Wenn Ihre Anwendung die WPD-API aus mehreren Threads aufruft, sollte jeder Thread eine neue instance der IPortableDevice-Schnittstelle erstellen. Dadurch wird sichergestellt, dass sich jeder Abbruchvorgang nur auf die E/A für den betroffenen Thread auswirkt.

Wenn beim Aufrufen der Cancel-Methode ein IStream-Schreibvorgang ausgeführt wird, sollte Ihre Anwendung alle Änderungen verwerfen, indem sie die IStream::Revert-Methode aufruft. Sobald die Änderungen verworfen wurden, sollte die Anwendung auch den Stream schließen, indem sie die IUnknown::Release-Methode aufruft.

Beachten Sie außerdem, dass die zu schreibenden Daten möglicherweise beschädigt sind, wenn die Cancel-Methode aufgerufen wird, bevor eine IStream::Write-Methode abgeschlossen wurde.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h
Bibliothek	PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDevice-Schnittstelle