Compartilhar via

Método IFileSystemImage::ImportSpecificFileSystem (imapi2fs.h)

  • Artigo

Importe um sistema de arquivos específico do disco.

Sintaxe

HRESULT ImportSpecificFileSystem(
  [in] FsiFileSystems fileSystemToUse
);

Parâmetros

[in] fileSystemToUse

Identifica o sistema de arquivos a ser importado. Para obter valores possíveis, consulte o tipo de enumeração FsiFileSystems .

Valor retornado

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
IMAPI_E_INVALID_PARAM
 O valor especificado para o parâmetro %1!ls! não é válido.

Valor: 0xC0AAB101
IMAPI_E_MULTISESSION_NOT_SET
 A propriedade MultisessionInterfaces deve ser definida antes de chamar esse método.

Valor: 0xC0AAB15D
IMAPI_E_BOOT_OBJECT_CONFLICT
 Um objeto de inicialização só pode ser incluído em uma imagem de disco inicial.

Valor: 0xC0AAB149
IMAPI_E_EMPTY_DISC
 A mídia óptica está vazia.

Valor: 0xC0AAB150
E_OUTOFMEMORY
 Falha ao alocar a memória necessária.

Valor: 0x8007000E
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE
 O IMAPI não dá suporte a nenhum dos tipos de multissessão fornecidos na mídia atual.

Valor: 0xC0AAB15C

Observação O método IFileSystemImage::ImportFileSystem retornará esse erro se não houver mídia no dispositivo de gravação.
 
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION
 Falha na operação devido ao layout incompatível da sessão anterior importada do meio.

Valor: 0xC0AAB133
IMAPI_E_FILE_SYSTEM_NOT_FOUND
 O disco especificado não contém um '%1!ls!' .

Valor: 0xC0AAB152
IMAPI_E_INVALID_PATH
 O sistema de arquivos especificado para importação contém um nome de arquivo inválido.

Valor: 0xC0AAB110

Comentários

Você deve chamar IFileSystemImage::p ut_MultisessionInterfaces antes de chamar IFileSystemImage::ImportSpecificFileSystem. Além disso, é recomendável que IDiscFormat2::get_MediaHeuristicallyBlank seja chamado antes de IFileSystemImage::p ut_MultisessionInterfaces para verificar se a mídia não está em branco.

Você pode chamar esse método a qualquer momento durante a construção do sistema de arquivos na memória. Se, durante a importação, um arquivo ou diretório já existir na cópia na memória, a versão na memória será mantida; o arquivo importado será descartado.

Em mídia gravável (DVD+/-RW, DVDRAM, BD-RE), a importação ou a queima de uma segunda sessão não terá suporte se a primeira sessão tiver um sistema de arquivos ISO9660, devido a limitações do sistema de arquivos.

Esse método lê apenas as informações do arquivo. Se o item for um arquivo, os dados do arquivo serão copiados ao chamar o método IFsiDirectoryItem::AddFile, IFsiDirectoryItem::AddTree ou IFsiDirectoryItem::Add .

esse método retornará IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION se o layout do sistema de arquivos na última sessão for incompatível com o layout usado pelo IMAPI para a criação de sistemas de arquivos solicitados para a imagem de resultado. Para obter mais detalhes, consulte a documentação do método IFileSystemImage::p ut_FileSystemsToCreate . Se o sistema de arquivos especificado por fileSystemToUse não tiver sido encontrado, esse método retornará IMAPI_E_FILE_SYSTEM_NOT_FOUND.

Requisitos

   
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 imapi2fs.h

Confira também

IFileSystemImage