Metodo IFileSystemImage::ImportFileSystem (imapi2fs.h)

  • Articolo

Importa il file system predefinito sul disco corrente.

Sintassi

HRESULT ImportFileSystem(
  [out] FsiFileSystems *importedFileSystem
);

Parametri

[out] importedFileSystem

Identifica il file system importato. 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
E_POINTER
 Puntatore non valido.

Valore: 0x80004003
IMAPI_E_MULTISESSION_NOT_SET
 La proprietà MultisessionInterfaces deve essere impostata prima di chiamare questo metodo.

Valore: 0xC0AAB15D
IMAPI_E_EMPTY_DISC
 I supporti ottici sono vuoti.

Valore: 0xC0AAB150
IMAPI_E_NO_SUPPORTED_FILE_SYSTEM
 Il disco specificato non contiene uno dei file system supportati. Valore: 0xC0AAB151
Nota È probabile che i file system siano supportati per l'operazione, ma a livelli bassi, IMAPI2 quando si chiama ImportFileSystem, ha una gestione generica di eccezioni/errori e segnala l'errore 0xC0AAB151. Se il disco non viene acquisito per l'accesso esclusivo o l'accesso negato, questo errore non verrà segnalato.
IMAPI_E_BOOT_OBJECT_CONFLICT
 Un oggetto di avvio può essere incluso solo in un'immagine disco iniziale.

Valore: 0xC0AAB149
E_OUTOFMEMORY
 Impossibile allocare la memoria richiesta.

Valore: 0x8007000E
IMAPI_E_IMAGE_TOO_BIG
 Il valore specificato per la proprietà FreeMediaBlocks è troppo piccolo per le dimensioni stimate dell'immagine in base ai dati correnti.

Valore: 0xC0AAB121
IMAPI_E_INVALID_PARAM
 Il valore specificato per il parametro %1!ls! non è valido.

Valore: 0xC0AAB101
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

Commenti

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

Se il disco contiene più file system, viene importato un solo file system. Questo metodo sceglie il file system da importare nell'ordine seguente: funzione definita dall'utente, Eseguit, ISO 9660. L'importazione include il trasferimento di directory e file nella struttura del file system in memoria.

È 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.

Per determinare quale file system è il file system predefinito per il disco, chiamare il metodo IFileSystemImage::GetDefaultFileSystemForImport .

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_NO_SUPPORTED_FILE_SYSTEM se non viene trovato un file system supportato nell'ultima sessione. Inoltre, 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 .

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

FsiFileSystems

IFileSystemImage