Direttiva INF DelFiles

Articolo
02/07/2024

Attenzione

Se si sta creando un pacchetto universale o driver di Windows, questa direttiva non è valida. Vedere Uso di un file INF universale e Introduzione con i driver di Windows.

Una direttiva DelFiles fa riferimento a una sezione definita da INF-writer altrove nel file INF e fa sì che tale elenco di file venga eliminato nel contesto delle operazioni nella sezione in cui viene specificata la direttiva DelFiles di riferimento.

[DDInstall] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows) 
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows) 
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows) 
  
Delfiles=file-list-section[,file-list-section]...

È possibile specificare una direttiva DelFiles all'interno di una delle sezioni illustrate nell'istruzione di sintassi formale. Questa direttiva può essere specificata anche all'interno di una delle sezioni INF-writer-defined seguenti:

Una sezione add-interface a cui fa riferimento la direttiva AddInterface in una DDInstall. Sezione Interfacce .
Sezione install-interface a cui si fa riferimento in una sezione InterfaceInstall32

Ogni sezione denominata a cui fa riferimento una direttiva DelFiles include una o più voci del formato seguente:

[file-list-section]
 
destination-file-name[,,,flag]
...

Una sezione file-list-section può avere un numero qualsiasi di voci, ognuna in una riga separata.

Voci

destination-file-name
Specifica il nome del file da eliminare dalla destinazione.

Non specificare un file elencato in una direttiva CopyFiles . Se un file è elencato sia in una sezione a cui viene fatto riferimento a CopyFiles che in una sezione a cui si fa riferimento a DelFiles e il file è attualmente presente nel sistema con una firma valida, il sistema operativo potrebbe ottimizzare l'operazione di copia, ma eseguire l'operazione di eliminazione. È molto probabile che questo non sia quello previsto dal writer INF.

Nota

Non è possibile utilizzare un token %strkey% per specificare la voce destination-file-name. Per altre informazioni sui token %strkey%, vedere la sezione Stringhe INF.

flag
Questo valore facoltativo può essere uno dei seguenti, espresso in notazione esadecimale, come illustrato di seguito o come valore decimale:

0x00000001 (DELFLG_IN_USE)
Eliminare il file denominato, possibilmente dopo che è stato usato durante il processo di installazione.

L'impostazione di questo valore di flag in una coda INF accoda l'operazione di eliminazione file fino al riavvio del sistema se il file specificato non può essere eliminato perché è in uso durante l'elaborazione di questo inF. In caso contrario, tale file non verrà eliminato.

0x00010000 (DELFLG_IN_USE1) (Windows 2000 o versioni successive di Windows)
Questo flag è una versione ad alta parola del flag DELFLG_IN_USE e ha lo stesso scopo e effetto. Questo flag deve essere utilizzato solo per le installazioni nei sistemi basati su NT.

L'impostazione di questo valore di flag in un INF impedisce conflitti con il flag COPYFLG_WARN_IF_SKIP in un INF con direttive DelFiles e CopyFiles che fanno riferimento alla stessa sezione file-list-section.

Commenti

Importante

Questa direttiva deve essere utilizzata con attenzione. È consigliabile non usare la direttiva DelFiles nel file INF per un driver di funzione Plug and Play (PnP).

Qualsiasi nome di sezione file-list deve essere univoco per il file INF, ma può essere fatto riferimento alle direttive CopyFiles, DelFiles o RenFiles in un'altra posizione nello stesso INF. Un nome di sezione definito da INF-writer deve seguire le regole generali per la definizione dei nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.

La direttiva DelFiles non supporta la decorazione di un nome di sezione file-list con estensione della piattaforma definita dal sistema (.nt, .ntx86, .ntia64, .ntamd64, .ntarm o .ntarm64).

La sezione DestinationDirs del file INF controlla la destinazione per tutte le operazioni di eliminazione di file, indipendentemente dalla sezione che contiene una specifica direttiva DelFiles . Se una sezione denominata a cui fa riferimento una direttiva DelFiles ha una voce corrispondente nella sezione DestinationDirs della stessa inF, tale voce specifica in modo esplicito la directory di destinazione da cui verranno eliminati tutti i file elencati nella sezione denominata. Se la sezione denominata non è elencata nella sezione DestinationDirs , Windows usa la voce DefaultDestDir in INF.

Esempio

In questo esempio viene illustrato come la sezione DestinationDirs specifica il percorso di un'operazione delete-file che si verifica durante l'elaborazione di un semplice INF del driver di dispositivo.

[DestinationDirs]
DefaultDestDir = 12  ; DIRID_DRIVERS 

; ... 

[AHA154X]
CopyFiles=@AHA154x.MPD
DelFiles=ASPIDEV ; defines delete-files section name
; ... some other directives and sections omitted here

[ASPIDEV]
VASPID.SYS ; name of file to be deleted, if it exists on target 
; ...