Compartir a través de

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

  • Artículo

Importa el sistema de archivos predeterminado en el disco actual.

Sintaxis

HRESULT ImportFileSystem(
  [out] FsiFileSystems *importedFileSystem
);

Parámetros

[out] importedFileSystem

Identifica el sistema de archivos importado. Para conocer los valores posibles, consulte el tipo de enumeración FsiFileSystems .

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los siguientes códigos de error se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto Descripción
E_POINTER
 El puntero no es válido.

Valor: 0x80004003
IMAPI_E_MULTISESSION_NOT_SET
 La propiedad MultisessionInterfaces debe establecerse antes de llamar a este método.

Valor: 0xC0AAB15D
IMAPI_E_EMPTY_DISC
 Los medios ópticos están vacíos.

Valor: 0xC0AAB150
IMAPI_E_NO_SUPPORTED_FILE_SYSTEM
 El disco especificado no contiene uno de los sistemas de archivos admitidos. Valor: 0xC0AAB151
Nota Es probable que los sistemas de archivos sean compatibles con la operación, pero en los niveles bajos, IMAPI2 al llamar a ImportFileSystem, tiene un control genérico de excepciones o errores e informa del error de vuelta 0xC0AAB151. Si el disco no se adquiere para el acceso exclusivo o se deniega el acceso, este error no se notificará.
IMAPI_E_BOOT_OBJECT_CONFLICT
 Un objeto de arranque solo se puede incluir en una imagen de disco inicial.

Valor: 0xC0AAB149
E_OUTOFMEMORY
 No se pudo asignar la memoria necesaria.

Valor: 0x8007000E
IMAPI_E_IMAGE_TOO_BIG
 El valor especificado para la propiedad FreeMediaBlocks es demasiado pequeño para el tamaño estimado de la imagen en función de los datos actuales.

Valor: 0xC0AAB121
IMAPI_E_INVALID_PARAM
 El valor especificado para el parámetro %1!ls! no es válido.

Valor: 0xC0AAB101
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE
 IMAPI no admite ninguno de los tipos de multisesión proporcionados en el medio actual.

Valor: 0xC0AAB15C

NotaEl método IFileSystemImage::ImportFileSystem devuelve este error si no hay ningún medio en el dispositivo de grabación.
 
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION
 Error en la operación debido a un diseño incompatible de la sesión anterior importada desde el medio.

Valor: 0xC0AAB133

Comentarios

Debe llamar a IFileSystemImage::p ut_MultisessionInterfaces antes de llamar a IFileSystemImage::ImportFileSystem. Además, se recomienda llamar a IDiscFormat2::get_MediaHeuristicallyBlank antes de IFileSystemImage::p ut_MultisessionInterfaces para comprobar que el medio no está en blanco.

Si el disco contiene más de un sistema de archivos, solo se importa un sistema de archivos. Este método elige el sistema de archivos que se va a importar en el siguiente orden: UDF, Joliet, ISO 9660. La importación incluye la transferencia de directorios y archivos a la estructura del sistema de archivos en memoria.

Puede llamar a este método en cualquier momento durante la construcción del sistema de archivos en memoria. Si, durante la importación, ya existe un archivo o directorio en la copia en memoria, se conservará la versión en memoria; se descartará el archivo importado.

Para determinar qué sistema de archivos es el sistema de archivos predeterminado para el disco, llame al método IFileSystemImage::GetDefaultFileSystemForImport .

Este método solo lee la información del archivo. Si el elemento es un archivo, los datos del archivo se copian al llamar al método IFsiDirectoryItem::AddFile, IFsiDirectoryItem::AddTree o IFsiDirectoryItem::Add .

Este método devuelve IMAPI_E_NO_SUPPORTED_FILE_SYSTEM si no se encuentra un sistema de archivos compatible en la última sesión. Además, este método devuelve IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION si el diseño del sistema de archivos de la última sesión no es compatible con el diseño usado por IMAPI para la creación de sistemas de archivos solicitados para la imagen de resultado. Para obtener más información, consulte la documentación del método IFileSystemImage::p ut_FileSystemsToCreate .

Requisitos

   
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imapi2fs.h

Consulte también

FsiFileSystems

IFileSystemImage