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 |
|---|---|
|
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 |