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

Vedi anche

Interfaccia IPortableDevice