Compartilhar via


Método IDiscRecorder::Erase (imapi.h)

Tenta apagar a mídia CD-RW se este for um gravador de disco CD-RW. Há suporte para erases completas e rápidas.

Sintaxe

HRESULT Erase(
  [in] boolean bFullErase
);

Parâmetros

[in] bFullErase

Indica o tipo de apagamento. Se esse parâmetro for FALSE, uma apagamento rápido será executada. Se esse parâmetro for TRUE, uma apagamento completo será executada.

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:

Comentários

Apagar um disco pode ser uma operação muito longa (às vezes, mais de uma hora). Para receber uma notificação de conclusão de apagamento, use IDiscMasterProgressEvents::NotifyEraseComplete.

A opção rápida apaga apenas o PMA, o TOC da primeira sessão e o intervalo pré-intervalo da primeira faixa. Isso apaga rapidamente um disco (entre 1 e 2 minutos, dependendo da velocidade do gravador), mas a área do programa ainda conterá dados do usuário. Um apagamento completo, por outro lado, apaga todo o disco.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [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 imapi.h
Biblioteca Uuid.lib
DLL Actxprxy.dll

Confira também

IDiscRecorder