Metodo IFileSystemImage::ImportFileSystem (imapi2fs.h)
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 |
|---|---|
|
Puntatore non valido.
Valore: 0x80004003 |
|
La proprietà MultisessionInterfaces deve essere impostata prima di chiamare questo metodo.
Valore: 0xC0AAB15D |
|
I supporti ottici sono vuoti.
Valore: 0xC0AAB150 |
|
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.
|
|
Un oggetto di avvio può essere incluso solo in un'immagine disco iniziale.
Valore: 0xC0AAB149 |
|
Impossibile allocare la memoria richiesta.
Valore: 0x8007000E |
|
Il valore specificato per la proprietà FreeMediaBlocks è troppo piccolo per le dimensioni stimate dell'immagine in base ai dati correnti.
Valore: 0xC0AAB121 |
|
Il valore specificato per il parametro %1!ls! non è valido.
Valore: 0xC0AAB101 |
|
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.
|
|
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 |