Método IDiscFormat2Data::CancelWrite (imapi2.h)
Cancela a operação de gravação atual.
Sintaxe
HRESULT CancelWrite();
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 geralmente 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: 0xC0AA0401 |
|
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 DDiscFormat2DataEvents::Update implementado.
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 da 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 deixa a mídia em um estado indeterminado. Para mídia reescrita, você deve chamar o método IDiscFormat2Erase::EraseMedia depois de chamar esse método para preparar a mídia para uso futuro.
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 |