IFileSystemImage::ImportSpecificFileSystem-Methode (imapi2fs.h)
Importieren Sie ein bestimmtes Dateisystem von einem Datenträger.
Syntax
HRESULT ImportSpecificFileSystem(
[in] FsiFileSystems fileSystemToUse
);
Parameter
[in] fileSystemToUse
Gibt das zu importierende Dateisystem an. 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 für den Parameter %1!ls! angegebene Wert ist ungültig.
Wert: 0xC0AAB101 |
|
Die MultisessionInterfaces-Eigenschaft muss vor dem Aufrufen dieser Methode festgelegt werden.
Wert: 0xC0AAB15D |
|
Ein Startobjekt kann nur in ein anfängliches Datenträgerimage eingeschlossen werden.
Wert: 0xC0AAB149 |
|
Optische Medien sind leer.
Wert: 0xC0AAB150 |
|
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
|
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 |
|
Der angegebene Datenträger enthält kein '%1!ls!' -Dateisystem durchgeführt.
Wert: 0xC0AAB152 |
|
Das für den Import angegebene Dateisystem enthält einen ungültigen Dateinamen.
Wert: 0xC0AAB110 |
Hinweise
Sie müssen IFileSystemImage::p ut_MultisessionInterfaces aufrufen, bevor Sie IFileSystemImage::ImportSpecificFileSystem 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.
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.
Auf wieder beschreibbaren Medien (DVD+/-RW, DVDRAM, BD-RE) wird das Importieren oder Brennen einer zweiten Sitzung aufgrund von Dateisystemeinschränkungen nicht unterstützt, wenn die erste Sitzung über ein ISO9660-Dateisystem verfügt.
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_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 wird. Weitere Informationen finden Sie in der Dokumentation zur IFileSystemImage::p ut_FileSystemsToCreate-Methode . Wenn das von fileSystemToUse angegebene Dateisystem nicht gefunden wurde, gibt diese Methode IMAPI_E_FILE_SYSTEM_NOT_FOUND zurück.
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 |