Compartilhar via


Método IDiscMaster::ClearFormatContent (imapi.h)

Limpa o conteúdo de uma imagem não queimada (o arquivo de stash atual).

Sintaxe

HRESULT ClearFormatContent();

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

O arquivo stash é uma estrutura interna usada para preparar um disco antes de gravá-lo na mídia.

SetActiveDiscRecorder determina se há um disco de várias sessões IMAPI na unidade ativa. Nesse caso, o IMAPI entra automaticamente no modo de várias sessões. Usar ClearFormatContent depois que o modo de várias sessões tiver sido estabelecido faz com que o IMAPI retorne ao modo de sessão única. Isso significa que um disco em branco é necessário para uma gravação RecordDisc .

Cuidado Use o cuidado ao chamar esse método. Não há confirmação nem recuperação. Se um aplicativo preencher o arquivo de imagem com dados, chamará esse método, os dados desaparecerão.
 

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

IDiscMaster