Método IFileSystemImage::ImportFileSystem (imapi2fs.h)
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 |
---|---|
|
El puntero no es válido.
Valor: 0x80004003 |
|
La propiedad MultisessionInterfaces debe establecerse antes de llamar a este método.
Valor: 0xC0AAB15D |
|
Los medios ópticos están vacíos.
Valor: 0xC0AAB150 |
|
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á.
|
|
Un objeto de arranque solo se puede incluir en una imagen de disco inicial.
Valor: 0xC0AAB149 |
|
No se pudo asignar la memoria necesaria.
Valor: 0x8007000E |
|
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 |
|
El valor especificado para el parámetro %1!ls! no es válido.
Valor: 0xC0AAB101 |
|
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.
|
|
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 |