Compartilhar via


Método IJolietDiscMaster::AddData (imapi.h)

Adiciona o conteúdo de um armazenamento raiz ao arquivo de imagem preparado. Esse armazenamento será enumerado para colocar todos os substorages e fluxos no sistema de arquivos raiz do arquivo de imagem de estágio. Os substorages se tornam pastas e os fluxos se tornam arquivos. Várias chamadas para esse método podem ser repetidas para preparar lentamente um arquivo de imagem sem desperdiçar quantidades indevidas de espaço em disco rígido criando um arquivo de armazenamento.

Sintaxe

HRESULT AddData(
  [in] IStorage *pStorage,
  [in] long     lFileOverwrite
);

Parâmetros

[in] pStorage

Caminho para o armazenamento cujos subitens devem ser adicionados à raiz do arquivo de imagem em etapas.

[in] lFileOverwrite

Se esse parâmetro não for zero, substitua arquivos existentes com o mesmo nome. Caso contrário, o último arquivo adicionado aparecerá no diretório.

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:

Comentários

Quando você repete uma operação AddData , pastas com arquivos duplicados causam um teste de lFileOverwrite. Se o sinalizador não for zero, o arquivo será substituído. Arquivos anteriores com nomes conflitantes ainda são gravados no disco do arquivo de imagem. Se lFileOverwrite for zero e existir um arquivo com o mesmo nome, AddData falhará com IMAPI_E_FILEEXISTS.

Embora AddData possa ser chamado várias vezes depois de chamar IDiscMaster::SetActiveDiscRecorder, SetActiveDiscRecorder deve ser chamado sempre que uma nova imagem é iniciada e imediatamente antes da primeira chamada AddData , independentemente de o queimador ser o mesmo usado na criação da imagem anterior.

Se uma chamada a esse método ultrapassar o número de blocos de dados disponíveis, o método retornará IMAPI_E_DISCFULL e ignorará todos os dados que seriam adicionados. Isso garante que o sistema de arquivos Joliet final não esteja corrompido.

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

IJolietDiscMaster