Compartir a través de

Método IDiscFormat2RawCD::CancelWrite (imapi2.h)

  • Artículo

Cancela la operación de escritura actual.

Sintaxis

HRESULT CancelWrite();

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los siguientes códigos de error se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto Descripción
E_IMAPI_DF2RAW_WRITE_NOT_IN_PROGRESS
 Actualmente no hay ninguna operación de escritura en curso.

Valor: 0xC0AA0601
E_FAIL
 Error no especificado.

Valor: 0x80004005

Comentarios

Para cancelar la operación de escritura, debe llamar a este método desde el controlador de eventos DDiscFormat2RawCDEvents::Update que implementó.

También debe llamar al método IDiscFormat2RawCD::ReleaseMedia después de llamar a este método.

Tenga en cuenta que llamar a este método no cancela inmediatamente la operación de escritura en todos los medios debido a los requisitos específicos de los medios. Por ejemplo, al escribir en un CD, la operación de escritura puede continuar durante hasta tres minutos más.

Este método deja el medio en un estado indeterminado. Para medios reescriturables, debe llamar al método IDiscFormat2Erase::EraseMedia después de llamar a este método para preparar el medio para su uso futuro.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imapi2.h

Consulte también

DDiscFormat2RawCDEvents::Update

IDiscFormat2RawCD