Método IDiscFormat2TrackAtOnce::CancelAddTrack (imapi2.h)
Cancela a operação de gravação atual.
Sintaxe
HRESULT CancelAddTrack();
Retornar valor
S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
| Código de retorno | Descrição |
|---|---|
|
Não há nenhuma operação de gravação em andamento no momento.
Valor: 0xC0AA0501 |
|
Falha não especificada.
Valor: 0x80004005 |
Comentários
Para cancelar a operação de gravação, você deve chamar esse método do manipulador de eventos DDiscFormat2TrackAtOnceEvents::Update que você implementou.
Você também deve chamar o método IDiscFormat2TrackAtOnce::ReleaseMedia depois de chamar esse método.
Observe que chamar esse método não cancela imediatamente a operação de gravação em todas as mídias devido a requisitos específicos de mídia. Por exemplo, ao gravar em um CD, a operação de gravação pode continuar por mais três minutos.
Esse método pode resultar em uma faixa de áudio parcial já ter sido gravada. O método tentará manter a mídia em um estado utilizável e simplesmente tratará a faixa cancelada como sendo mais curta do que a descrita originalmente pelo IStream. Os chamadores devem consultar o número de faixas e controlar tamanhos após o cancelamento para determinar o estado do disco.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imapi2.h |