IFileSystemImage::ImportFileSystem-Methode (imapi2fs.h)

  • Artikel

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
E_POINTER
 Der Zeiger ist ungültig.

Wert: 0x80004003
IMAPI_E_MULTISESSION_NOT_SET
 Die MultisessionInterfaces-Eigenschaft muss vor dem Aufrufen dieser Methode festgelegt werden.

Wert: 0xC0AAB15D
IMAPI_E_EMPTY_DISC
 Optische Medien sind leer.

Wert: 0xC0AAB150
IMAPI_E_NO_SUPPORTED_FILE_SYSTEM
 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.
IMAPI_E_BOOT_OBJECT_CONFLICT
 Ein Startobjekt kann nur in ein anfängliches Datenträgerimage eingeschlossen werden.

Wert: 0xC0AAB149
E_OUTOFMEMORY
 Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.

Wert: 0x8007000E
IMAPI_E_IMAGE_TOO_BIG
 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
IMAPI_E_INVALID_PARAM
 Der für den Parameter %1!ls! angegebene Wert ist ungültig.

Wert: 0xC0AAB101
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE
 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.
 
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION
 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

Weitere Informationen

FsiFileSystems

IFileSystemImage