INF DelFiles-instructie

Caution

Als u een universeel of Windows stuurprogrammapakket bouwt, is deze richtlijn niet geldig. Zie Een universeel INF-bestand gebruiken en aan de slag met het ontwikkelen van Windows stuurprogramma's.

Een DelFiles-instructie verwijst naar een inF-schrijver gedefinieerde sectie elders in het INF-bestand en zorgt ervoor dat de lijst met bestanden wordt verwijderd in de context van bewerkingen in de sectie waarin de verwijzende DelFiles-instructie is opgegeven.

[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]... 

Een DelFiles-instructie kan worden opgegeven in een van de secties die worden weergegeven in de formele syntaxisinstructie. Deze richtlijn kan ook worden opgegeven in een van de volgende inF-schrijver gedefinieerde secties:

Elke benoemde sectie waarnaar wordt verwezen door een DelFiles-instructie heeft een of meer vermeldingen van het volgende formulier:

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

Een bestandslijstsectie kan een willekeurig aantal vermeldingen bevatten, elk op een afzonderlijke regel.

Invoer

destination-file-name
Hiermee geeft u de naam op van het bestand dat van de bestemming moet worden verwijderd.

Geef geen bestand op dat wordt vermeld in een CopyFiles-instructie . Als een bestand wordt vermeld in zowel de sectie CopyFiles waarnaar wordt verwezen als een sectie waarnaar wordt verwezen door DelFiles, en het bestand momenteel aanwezig is op het systeem met een geldige handtekening, kan het besturingssysteem de kopieerbewerking optimaliseren, maar de verwijderbewerking uitvoeren. Dit is waarschijnlijk niet wat de INF-schrijver bedoelde.

Note

U kunt geen %strkey% token gebruiken om de vermelding van de doelbestandsbestandsnaam op te geven. Zie de sectie INF-tekenreeksen voor meer informatie over %strkey% tokens.

flag
Deze optionele waarde kan een van de volgende zijn, uitgedrukt in hexadecimale notatie, zoals hier wordt weergegeven of als een decimale waarde:

0x00000001 (DELFLG_IN_USE)
Verwijder het benoemde bestand, mogelijk nadat het is gebruikt tijdens het installatieproces.

Als u deze vlagwaarde instelt in een INF-wachtrij, wordt de bewerking voor het verwijderen van bestanden uitgevoerd totdat het systeem opnieuw is opgestart als het opgegeven bestand niet kan worden verwijderd omdat het in gebruik is terwijl deze INF wordt verwerkt. Anders wordt een dergelijk bestand niet verwijderd.

0x00010000 (DELFLG_IN_USE1) (Windows 2000 of nieuwere versies van Windows)
Deze vlag is een hoge woordversie van de DELFLG_IN_USE vlag en heeft hetzelfde doel en effect. Deze vlag mag alleen worden gebruikt voor installaties op systemen op basis van NT.

Als u deze vlagwaarde instelt in een INF, voorkomt u conflicten met de vlag COPYFLG_WARN_IF_SKIP in een INF met zowel DelFiles - als CopyFiles-instructies die verwijzen naar dezelfde bestandslijstsectie.

Remarks

Important

Deze richtlijn moet zorgvuldig worden gebruikt. We raden u ten zeerste aan de DelFiles-instructie niet te gebruiken in het INF-bestand voor een Plug en Play (PnP)-functiestuurprogramma.

Elke naam van een bestandslijstsectie moet uniek zijn voor het INF-bestand, maar kan worden verwezen door de instructies CopyFiles, DelFiles of RenFiles elders in dezelfde INF. Een dergelijke inF-schrijver gedefinieerde sectienaam moet voldoen aan de algemene regels voor het definiƫren van sectienamen. Zie Algemene syntaxisregels voor INF-bestanden voor meer informatie over deze regels.

De DelFiles-instructie biedt geen ondersteuning voor het decoreren van een bestandsnaamlijstsectie met een door het systeem gedefinieerde platformextensie (.nt, .ntx86, .ntia64, .ntamd64, .ntarm of .ntarm64).

De sectie DestinationDirs van het INF-bestand bepaalt de bestemming voor alle bewerkingen voor het verwijderen van bestanden, ongeacht de sectie die een bepaalde DelFiles-instructie bevat. Als een benoemde sectie waarnaar wordt verwezen door een DelFiles-instructie een overeenkomende vermelding heeft in de sectie DestinationDirs van hetzelfde INF, geeft die vermelding expliciet de doelmap aan waaruit alle bestanden die in de benoemde sectie worden vermeld, worden verwijderd. Als de benoemde sectie niet wordt vermeld in de sectie DestinationDirs, gebruikt Windows de vermelding DefaultDestDir in de INF.

Examples

In dit voorbeeld ziet u hoe in de sectie DestinationDirs het pad wordt opgegeven voor een verwijderbestandsbewerking die plaatsvindt bij het verwerken van een eenvoudig INF-stuurprogramma van het apparaatstuurprogramma.

[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 
; ...

Zie ook

AddInterface

ClassInstall32

CopyFiles

DDInstall

DestinationDirs

InterfaceInstall32

RenFiles

Tekenreeksen