IFileSystemImage::ImportFileSystem, méthode (imapi2fs.h)
Importe le système de fichiers par défaut sur le disque actif.
Syntaxe
HRESULT ImportFileSystem(
[out] FsiFileSystems *importedFileSystem
);
Paramètres
[out] importedFileSystem
Identifie le système de fichiers importé. Pour connaître les valeurs possibles, consultez le type d’énumération FsiFileSystems .
Valeur retournée
S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :
| Code de retour | Description |
|---|---|
|
Le pointeur n’est pas valide.
Valeur : 0x80004003 |
|
La propriété MultisessionInterfaces doit être définie avant d’appeler cette méthode.
Valeur : 0xC0AAB15D |
|
Le support optique est vide.
Valeur : 0xC0AAB150 |
|
Le disque spécifié ne contient pas l’un des systèmes de fichiers pris en charge.
Valeur : 0xC0AAB151 Note Les systèmes de fichiers sont probablement pris en charge pour l’opération, mais aux faibles niveaux IMAPI2 lors de l’appel d’ImportFileSystem, il a une gestion générique des exceptions/erreurs et signale 0xC0AAB151 d’erreur. Si le disque n’est pas acquis pour un accès exclusif ou si l’accès n’est pas refusé, cette erreur n’est pas signalée.
|
|
Un objet de démarrage ne peut être inclus que dans une image de disque initiale.
Valeur : 0xC0AAB149 |
|
Impossible d’allouer la mémoire requise.
Valeur : 0x8007000E |
|
La valeur spécifiée pour la propriété FreeMediaBlocks est trop petite pour une taille d’image estimée en fonction des données actuelles.
Valeur : 0xC0AAB121 |
|
La valeur spécifiée pour le paramètre %1!ls! n’est pas valide.
Valeur : 0xC0AAB101 |
|
IMAPI ne prend en charge aucun des types multisession fournis sur le média actuel.
Valeur : 0xC0AAB15C Remarque La méthode IFileSystemImage::ImportFileSystem retourne cette erreur s’il n’y a pas de support dans le périphérique d’enregistrement.
|
|
L’opération a échoué en raison d’une disposition incompatible de la session précédente importée à partir du support.
Valeur : 0xC0AAB133 |
Notes
Vous devez appeler IFileSystemImage::p ut_MultisessionInterfaces avant d’appeler IFileSystemImage::ImportFileSystem. En outre, il est recommandé d’appeler IDiscFormat2::get_MediaHeuristicallyBlank avant IFileSystemImage::p ut_MultisessionInterfaces pour vérifier que le média n’est pas vide.
Si le disque contient plusieurs systèmes de fichiers, un seul système de fichiers est importé. Cette méthode choisit le système de fichiers à importer dans l’ordre suivant : UDF, Joliet, ISO 9660. L’importation inclut le transfert de répertoires et de fichiers vers la structure du système de fichiers en mémoire.
Vous pouvez appeler cette méthode à tout moment pendant la construction du système de fichiers en mémoire. Si, lors de l’importation, un fichier ou un répertoire existe déjà dans la copie en mémoire, la version en mémoire est conservée ; le fichier importé sera ignoré.
Pour déterminer quel système de fichiers est le système de fichiers par défaut du disque, appelez la méthode IFileSystemImage::GetDefaultFileSystemForImport .
Cette méthode lit uniquement les informations de fichier. Si l’élément est un fichier, les données du fichier sont copiées lors de l’appel de la méthode IFsiDirectoryItem::AddFile, IFsiDirectoryItem::AddTree ou IFsiDirectoryItem::Add .
Cette méthode retourne IMAPI_E_NO_SUPPORTED_FILE_SYSTEM si un système de fichiers pris en charge est introuvable dans la dernière session. En outre, cette méthode retourne IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION si la disposition du système de fichiers de la dernière session est incompatible avec la disposition utilisée par IMAPI pour la création des systèmes de fichiers demandés pour l’image de résultat. Pour plus d’informations, consultez la documentation sur la méthode IFileSystemImage::p ut_FileSystemsToCreate .
Spécifications
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imapi2fs.h |