IFileSystemImage::ImportFileSystem-Methode (imapi2fs.h)
Importiert das Standarddateisystem auf dem aktuellen Datenträger.
Syntax
HRESULT ImportFileSystem(
[out] FsiFileSystems *importedFileSystem
);
Parameter
[out] importedFileSystem
Identifiziert das importierte Dateisystem. Mögliche Werte finden Sie unter FsiFileSystems-Enumerationstyp .
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
|
Die MultisessionInterfaces-Eigenschaft muss vor dem Aufrufen dieser Methode festgelegt werden.
Wert: 0xC0AAB15D |
|
Optische Medien sind leer.
Wert: 0xC0AAB150 |
|
Der angegebene Datenträger enthält keins der unterstützten Dateisysteme.
Wert: 0xC0AAB151 Hinweis Die Dateisysteme werden wahrscheinlich für den Vorgang unterstützt, aber auf den niedrigen Ebenen ( IMAPI2 beim Aufrufen von ImportFileSystem) verfügt es über eine generische Ausnahme-/Fehlerbehandlung und meldet Fehler 0xC0AAB151. Wenn der Datenträger nicht für den exklusiven Zugriff abgerufen oder anderweitig verweigert wird, wird dieser Fehler nicht gemeldet.
|
|
Ein Startobjekt kann nur in ein anfängliches Datenträgerimage eingeschlossen werden.
Wert: 0xC0AAB149 |
|
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
|
Der für die FreeMediaBlocks-Eigenschaft angegebene Wert ist zu klein für die geschätzte Bildgröße basierend auf den aktuellen Daten.
Wert: 0xC0AAB121 |
|
Der für den Parameter %1!ls! angegebene Wert ist ungültig.
Wert: 0xC0AAB101 |
|
IMAPI unterstützt keinen der multisession-Typen, die auf den aktuellen Medien bereitgestellt werden.
Wert: 0xC0AAB15C Hinweis DieIFileSystemImage::ImportFileSystem-Methode gibt diesen Fehler zurück, wenn auf dem Aufzeichnungsgerät keine Medien vorhanden sind.
|
|
Fehler beim Vorgang aufgrund eines inkompatiblen Layouts der vorherigen Sitzung, die aus dem Medium importiert wurde.
Wert: 0xC0AAB133 |
Hinweise
Sie müssen IFileSystemImage::p ut_MultisessionInterfaces aufrufen, bevor Sie IFileSystemImage::ImportFileSystem aufrufen. Darüber hinaus wird empfohlen, dass IDiscFormat2::get_MediaHeuristicallyBlank vor IFileSystemImage::p ut_MultisessionInterfaces aufgerufen wird, um zu überprüfen, ob die Medien nicht leer sind.
Wenn der Datenträger mehrere Dateisysteme enthält, wird nur ein Dateisystem importiert. Diese Methode wählt das zu importierende Dateisystem in der folgenden Reihenfolge aus: UDF, Joliet, ISO 9660. Der Import umfasst das Übertragen von Verzeichnissen und Dateien in die In-Memory-Dateisystemstruktur.
Sie können diese Methode jederzeit während der Erstellung des In-Memory-Dateisystems aufrufen. Wenn beim Import bereits eine Datei oder ein Verzeichnis in der In-Memory-Kopie vorhanden ist, wird die In-Memory-Version beibehalten. Die importierte Datei wird verworfen.
Um zu bestimmen, welches Dateisystem das Standarddateisystem für den Datenträger ist, rufen Sie die IFileSystemImage::GetDefaultFileSystemForImport-Methode auf.
Diese Methode liest nur die Dateiinformationen. Wenn das Element eine Datei ist, werden die Dateidaten beim Aufrufen der IFsiDirectoryItem::AddFile-, IFsiDirectoryItem::AddTree- oder IFsiDirectoryItem::Add-Methode kopiert.
Diese Methode gibt IMAPI_E_NO_SUPPORTED_FILE_SYSTEM zurück, wenn in der letzten Sitzung kein unterstütztes Dateisystem gefunden wurde. Darüber hinaus gibt diese Methode IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION zurück, wenn das Layout des Dateisystems in der letzten Sitzung nicht mit dem Layout kompatibel ist, das von IMAPI für die Erstellung angeforderter Dateisysteme für das Ergebnisbild verwendet wurde. Weitere Informationen finden Sie in der Dokumentation zur IFileSystemImage::p ut_FileSystemsToCreate-Methode .
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2fs.h |