IFileSystemImage::ImportSpecificFileSystem, méthode (imapi2fs.h)

Article
08/24/2023

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
IMAPI_E_INVALID_PARAM	La valeur spécifiée pour le paramètre %1!ls! n’est pas valide. Valeur : 0xC0AAB101
IMAPI_E_MULTISESSION_NOT_SET	La propriété MultisessionInterfaces doit être définie avant d’appeler cette méthode. Valeur : 0xC0AAB15D
IMAPI_E_BOOT_OBJECT_CONFLICT	Un objet de démarrage ne peut être inclus que dans une image de disque initiale. Valeur : 0xC0AAB149
IMAPI_E_EMPTY_DISC	Le support optique est vide. Valeur : 0xC0AAB150
E_OUTOFMEMORY	Échec de l’allocation de la mémoire requise. Valeur : 0x8007000E
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	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.
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION	L’opération a échoué en raison d’une disposition incompatible de la session précédente importée à partir du support. Valeur : 0xC0AAB133
IMAPI_E_FILE_SYSTEM_NOT_FOUND	Le disque spécifié ne contient pas de '%1!ls!' . Valeur : 0xC0AAB152
IMAPI_E_INVALID_PATH	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

Voir aussi

IFileSystemImage

Partager via