Metodo IJolietDiscMaster::AddData (imapi.h)

Aggiunge il contenuto di un archivio radice al file immagine in fase. Questa risorsa di archiviazione verrà enumerata per inserire tutte le sottostorage e i flussi nel file system radice del file immagine di fase. Le sottostorage diventano cartelle e i flussi diventano file. Più chiamate a questo metodo possono essere ripetute per eseguire lentamente una fase di un file di immagine senza perdere quantità di spazio su disco rigido che crea un file di archiviazione.

Sintassi

HRESULT AddData(
  [in] IStorage *pStorage,
  [in] long     lFileOverwrite
);

Parametri

[in] pStorage

Percorso dell'archiviazione i cui elementi secondari devono essere aggiunti alla radice del file immagine in fase.

[in] lFileOverwrite

Se questo parametro è diverso da zero, sovrascrivere i file esistenti con lo stesso nome. In caso contrario, l'ultimo file aggiunto viene visualizzato nella directory.

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:

Commenti

Quando si ripete un'operazione AddData , le cartelle con file duplicati causano un test di lFileOverwrite. Se il flag è diverso da zero, il file viene sovrascritto. I file precedenti con nomi in conflitto vengono ancora scritti sul disco dal file di immagine. Se lFileOverwrite è zero e esiste un file con lo stesso nome, AddData ha esito negativo con IMAPI_E_FILEEXISTS.

Mentre AddData può essere chiamato più volte dopo aver chiamato IDiscMaster::SetActiveDiscRecorder, SetActiveDiscRecorder deve essere chiamato qualsiasi volta che viene avviata una nuova immagine e immediatamente prima della prima chiamata AddData, indipendentemente dal fatto che il masterizzatore sia lo stesso usato nella creazione dell'immagine precedente.

Se una chiamata a questo metodo supera il numero di blocchi di dati disponibili, il metodo restituisce IMAPI_E_DISCFULL e ignora tutti i dati da aggiungere. Ciò garantisce che il file system di Joliet finale non sia danneggiato.

Requisiti

Vedi anche

IJolietDiscMaster