Método IDiscFormat2TrackAtOnce::CancelAddTrack (imapi2.h)
Cancela la operación de escritura actual.
Sintaxis
HRESULT CancelAddTrack();
Valor devuelto
S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:
| Código devuelto | Descripción |
|---|---|
|
Actualmente no hay ninguna operación de escritura en curso.
Valor: 0xC0AA0501 |
|
Error no especificado.
Valor: 0x80004005 |
Comentarios
Para cancelar la operación de escritura, debe llamar a este método desde el controlador de eventos DDiscFormat2TrackAtOnceEvents::Update que implementó.
También debe llamar al método IDiscFormat2TrackAtOnce::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 un máximo de tres minutos más.
Este método puede dar lugar a que ya se haya grabado una pista de audio parcial. El método intentará mantener el medio en un estado utilizable y simplemente tratará la pista cancelada como más corta que la descrita originalmente por IStream. Los autores de llamadas deben consultar el número de pistas y tamaños de pista después de cancelar para determinar el estado del disco.
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 |