IFileSystemImage::ImportSpecificFileSystem, méthode (imapi2fs.h)
Importez un système de fichiers spécifique à partir d’un disque.
Syntaxe
HRESULT ImportSpecificFileSystem(
[in] FsiFileSystems fileSystemToUse
);
Paramètres
[in] fileSystemToUse
Identifie le système de fichiers à importer. 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 |
|---|---|
|
La valeur spécifiée pour le paramètre %1!ls! n’est pas valide.
Valeur : 0xC0AAB101 |
|
La propriété MultisessionInterfaces doit être définie avant d’appeler cette méthode.
Valeur : 0xC0AAB15D |
|
Un objet de démarrage ne peut être inclus que dans une image de disque initiale.
Valeur : 0xC0AAB149 |
|
Le support optique est vide.
Valeur : 0xC0AAB150 |
|
Échec de l’allocation de la mémoire requise.
Valeur : 0x8007000E |
|
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 média 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 |
|
Le disque spécifié ne contient pas de '%1!ls!' .
Valeur : 0xC0AAB152 |
|
Le système de fichiers spécifié pour l’importation contient un nom de fichier non valide.
Valeur : 0xC0AAB110 |
Notes
Vous devez appeler IFileSystemImage::p ut_MultisessionInterfaces avant d’appeler IFileSystemImage::ImportSpecificFileSystemSystem. 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.
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é.
Sur un support réinscriptible (DVD+/-RW, DVDRAM, BD-RE), l’importation ou la gravure d’une deuxième session ne sont pas prises en charge si la première session a un système de fichiers ISO9660, en raison des limitations du système de fichiers.
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_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 de 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 . Si le système de fichiers spécifié par fileSystemToUse n’a pas été trouvé, cette méthode retourne IMAPI_E_FILE_SYSTEM_NOT_FOUND.
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 |