Metodo IPortableDevice::Cancel (portabledeviceapi.h)
Il metodo Cancel annulla un'operazione in sospeso su questa interfaccia.
Sintassi
HRESULT Cancel();
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata annullata correttamente. |
Commenti
Se l'applicazione richiama l'API WPD da più thread, ogni thread deve creare una nuova istanza dell'interfaccia IPortableDevice . In questo modo si garantisce che qualsiasi operazione di annullamento influisca solo sull'I/O per il thread interessato.
Se è in corso un'operazione di scrittura IStream quando viene richiamato il metodo Cancel , l'applicazione deve eliminare tutte le modifiche richiamando il metodo IStream::Revert . Dopo aver rimosso le modifiche, l'applicazione deve anche chiudere il flusso richiamando il metodo IUnknown::Release .
Si noti inoltre che se il metodo Cancel viene richiamato prima del completamento di un metodo IStream::Write , i dati scritti potrebbero essere danneggiati.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | portabledeviceapi.h |
| Libreria | PortableDeviceGUIDs.lib |