FileSetAttrib

Ändert die Attribute von ein oder mehreren Dateien oder Ordnern. Platzhalter werden unterstützt.

FileSetAttrib, Attribute , DateiMuster, OrdnerEinbeziehen, Rekursiv

Parameter

Attribute

Attribute, die geändert werden sollen. Zum Beispiel +HA-R.

Um Attribute einfach ein-, aus- oder umzuschalten, stellen Sie einem oder mehreren der folgenden Attributbuchstaben ein Pluszeichen (+), Minuszeichen (-) oder Zirkumflex (^) voran:

• R = READONLY (schreibgeschützt)
• A = ARCHIVE (archiviert)
• S = SYSTEM (Systemdatei)
• H = HIDDEN (versteckt)
• N = NORMAL (nur ohne die anderen Attribute gültig)
• O = OFFLINE
• T = TEMPORARY (temporär)

Hinweis: Derzeit kann der Komprimierungsstatus von Dateien mit diesem Befehl nicht geändert werden.

DateiMuster

Wenn leer oder weggelassen, wird die aktuelle Datei der innersten umschlossenen Datei-Schleife verwendet. Andernfalls geben Sie den Namen einer Datei oder eines Ordners oder ein Platzhaltermuster wie z.B. C:\Temp\*.tmp an. Wenn kein absoluter Pfad angegeben ist, wird DateiMuster im A_WorkingDir-Verzeichnis vermutet.

OrdnerEinbeziehen

Wenn leer oder weggelassen, wird standardmäßig 0 verwendet. Andernfalls geben Sie eine der folgenden Ziffern an:

• 0 = Ordner werden nicht mit einbezogen (nur Dateien).
• 1 = Alle Dateien und Ordner, die dem Platzhaltermuster entsprechen, werden mit einbezogen.
• 2 = Nur Ordner werden mit einbezogen (keine Dateien).

Hinweis: Wenn DateiMuster ein einzelner Ordner anstelle eines Platzhaltermusters ist, wird er immer mit einbezogen, unabhängig von dieser Einstellung.

Dieser Parameter kann ein Ausdruck sein.

Rekursiv

Wenn leer oder weggelassen, wird standardmäßig 0 verwendet. Andernfalls geben Sie eine der folgenden Ziffern an:

• 0 = Unterordner werden nicht rekursiv durchwandert.
• 1 = Unterordner werden rekursiv durchwandert, d.h. auch alle darin befindlichen Dateien und Ordner, die dem DateiMuster entsprechen, werden mit einbezogen. Es werden alle Unterordner rekursiv durchwandert, nicht nur solche, die dem DateiMuster entsprechen. Dateien und Ordner, deren vollständiger Pfadname länger als 259 Zeichen ist, werden übersprungen, als wären sie nicht vorhanden. Dieses Problem tritt jedoch nur selten auf, weil das Betriebssystem solche Pfadnamen normalerweise nicht erlaubt.

Dieser Parameter kann ein Ausdruck sein.

Fehlerbehandlung

[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.

ErrorLevel wird bei Misserfolg auf die Anzahl der Dateien gesetzt, die nicht geändert werden konnten, und bei Erfolg auf 0.

Wenn Dateien gefunden wurden, wird A_LastError auf 0 oder das Ergebnis der Systemfunktion GetLastError() unmittelbar nach dem letzten Misserfolg gesetzt. Andernfalls enthält A_LastError einen Fehlercode, der eventuell kenntlich macht, warum keine Dateien gefunden wurden.

Siehe auch

FileGetAttrib, FileGetTime, FileSetTime, FileGetSize, FileGetVersion, Datei-Schleife

Beispiele

FileSetAttrib, +RH, C:\MeineDateien\*.*, 1  ; +RH ist identisch mit +R+H

FileSetAttrib, ^H, C:\MeineDateien

FileSetAttrib, -R+A, C:\Neue Textdatei.txt

FileSetAttrib, +A, C:\*.ini, , 1