Metodo IDiscFormat2Data::CancelWrite (imapi2.h)

Annulla l'operazione di scrittura corrente.

Sintassi

HRESULT CancelWrite();

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
E_IMAPI_DF2DATA_WRITE_NOT_IN_PROGRESS	Non è attualmente in corso alcuna operazione di scrittura. Valore: 0xC0AA0401
E_FAIL	Errore non specificato. Valore: 0x80004005

Commenti

Per annullare l'operazione di scrittura, è necessario chiamare questo metodo dal gestore eventi DDiscFormat2DataEvents::Update implementato.

Si noti che la chiamata a questo metodo non annulla immediatamente l'operazione di scrittura su tutti i supporti a causa di requisiti specifici del supporto. Ad esempio, quando si scrive in un CD, l'operazione di scrittura può continuare per un massimo di tre minuti.

Questo metodo lascia il supporto in uno stato indeterminato. Per i supporti riscritti, devi chiamare il metodo IDiscFormat2Erase::EraseMedia dopo aver chiamato questo metodo per preparare il supporto per un uso futuro.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2.h

Vedi anche

DWriteEngine2Events

IDiscFormat2Data

IDiscFormat2Data::Write