Metodo IFileSystemImage::ImportSpecificFileSystem (imapi2fs.h)

Articolo
08/24/2023

Importare un file system specifico dal disco.

Sintassi

HRESULT ImportSpecificFileSystem(
  [in] FsiFileSystems fileSystemToUse
);

Parametri

[in] fileSystemToUse

Identifica il file system da importare. Per i valori possibili, vedere il tipo di enumerazione FsiFileSystems .

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
IMAPI_E_INVALID_PARAM	Il valore specificato per il parametro %1!ls! non è valido. Valore: 0xC0AAB101
IMAPI_E_MULTISESSION_NOT_SET	La proprietà MultisessionInterfaces deve essere impostata prima di chiamare questo metodo. Valore: 0xC0AAB15D
IMAPI_E_BOOT_OBJECT_CONFLICT	Un oggetto di avvio può essere incluso solo in un'immagine disco iniziale. Valore: 0xC0AAB149
IMAPI_E_EMPTY_DISC	I supporti ottici sono vuoti. Valore: 0xC0AAB150
E_OUTOFMEMORY	Impossibile allocare la memoria richiesta. Valore: 0x8007000E
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	IMAPI supporta nessuno dei tipi multisessione forniti nel supporto corrente. Valore: 0xC0AAB15C Nota Il metodo IFileSystemImage::ImportFileSystem restituisce questo errore se non sono presenti supporti nel dispositivo di registrazione.
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION	Operazione non riuscita a causa del layout incompatibile della sessione precedente importata dal supporto. Valore: 0xC0AAB133
IMAPI_E_FILE_SYSTEM_NOT_FOUND	Il disco specificato non contiene '%1!ls!' . Valore: 0xC0AAB152
IMAPI_E_INVALID_PATH	Il file system specificato per l'importazione contiene un nome file non valido. Valore: 0xC0AAB110

Commenti

È necessario chiamare IFileSystemImage::p ut_MultisessionInterfaces prima di chiamare IFileSystemImage::ImportSpecificFileSystem. È inoltre consigliabile chiamare IDiscFormat2::get_MediaHeuristicallyBlank prima di IFileSystemImage::p ut_MultisessionInterfaces per verificare che il supporto non sia vuoto.

È possibile chiamare questo metodo in qualsiasi momento durante la costruzione del file system in memoria. Se, durante l'importazione, esiste già un file o una directory nella copia in memoria, la versione in memoria verrà mantenuta; il file importato verrà rimosso.

Nel supporto riscrivibile (DVD+/-RW, DVDRAM, BD-RE), l'importazione o la combustione di una seconda sessione non è supportata se la prima sessione ha un file system ISO9660, a causa delle limitazioni del file system.

Questo metodo legge solo le informazioni sul file. Se l'elemento è un file, i dati del file verranno copiati quando si chiama il metodo IFsiDirectoryItem::AddFile, IFsiDirectoryItem::AddTree o IFsiDirectoryItem::Add .

Questo metodo restituisce IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION se il layout del file system nell'ultima sessione non è compatibile con il layout utilizzato da IMAPI per la creazione di file system richiesti per l'immagine del risultato. Per altre informazioni, vedere la documentazione del metodo IFileSystemImage::p ut_FileSystemsToCreate . Se il file system specificato da fileSystemToUse non è stato trovato, questo metodo restituisce IMAPI_E_FILE_SYSTEM_NOT_FOUND.

Requisiti


Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2fs.h

Vedi anche

IFileSystemImage

Condividi tramite