Azione InstallFiles
L'azione InstallFiles copia i file specificati nella tabella File dalla directory di origine alla directory di destinazione.
Restrizioni della sequenza
L'azione InstallFiles deve essere eseguita dopo l'azione InstallValidate e prima di qualsiasi azione dipendente dal file.
Messaggi ActionData
| Campo | Descrizione dei dati delle azioni |
|---|---|
| [1] | Identificatore del file installato. |
| [6] | Dimensioni del file installato in byte. |
| [9] | Identificatore della directory che contiene il file installato. |
Commenti
L'azione InstallFiles opera sui file specificati nella tabella File. Ogni file viene installato in base allo stato di installazione del componente associato del file nella tabella Componente. Solo i file i cui componenti vengono risolti nello stato msiInstallStatelocal sono idonei per la copia.
L'azione InstallFiles implementa le colonne seguenti della tabella File.
- La colonna FileName specifica il nome del file di destinazione.
- La colonna Version specifica la versione del file.
- La colonna Attributes specifica i bit del flag di attributo di installazione e del file.
- La colonna File specifica il token di file univoco.
- La colonna FileSize specifica le dimensioni del file non compresso in byte.
- La colonna Language specifica l'identificatore di lingua del file.
- La colonna Sequenza specifica il numero di sequenza nel supporto.
L'azione InstallFiles implementa le colonne seguenti della tabella Component.
- La colonna Directory_ specifica un riferimento a un elemento della tabella Directory .
- La colonna Componente specifica un nome univoco per l'elemento del componente.
Il file specificato viene copiato solo se una delle condizioni seguenti è vera:
- Il file non è attualmente installato nel computer locale.
- Il file si trova nel computer locale, ma ha un numero di versione inferiore rispetto al file nella tabella File.
- Il file si trova nel computer locale, ma non esiste alcun numero di versione associato.
La directory di origine per ogni file da copiare è determinata da sourceMode, che a sua volta dipende dal valore nella colonna Cab della tabella Media. Per una descrizione completa della modalità di origine, vedere la tabella Media.
Se la directory di origine di un file da copiare si trova su supporti rimovibili, ad esempio un disco floppy o CD-ROM, l'azione InstallFiles verifica che il supporto di origine appropriato venga inserito prima di tentare di copiare il file. InstallFiles cerca il supporto dello stesso tipo rimovibile con un'etichetta di volume corrispondente al valore specificato nella colonna VolumeLabel della tabella Media. Se viene trovato un volume montato corrispondente, il processo di copia del file procede. Se non viene trovata alcuna corrispondenza, una finestra di dialogo richiede all'utente di inserire il supporto appropriato. In questo caso, la finestra di dialogo usa il nome multimediale trovato nella colonna DiskPrompt della tabella Media come parte della richiesta.
È necessario prestare attenzione perché l'azione InstallFiles può eliminare un file originale e non sostituirlo. Ciò si verifica quando l'azione InstallFiles genera un errore durante la sostituzione di un file precedente e l'utente sceglie di ignorare l'errore. Il comportamento predefinito del programma di installazione consiste nell'eliminare un file precedente prima di assicurarsi che il nuovo file venga copiato correttamente.
Per le regole di controllo delle versioni dei file usate dal programma di installazione, vedere Regole di controllo delle versioni dei file.