FileSetAttrib

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

FileSetAttrib Attribute , DateiMuster, Modus

Parameter

Attribute

Typ: Zeichenkette

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 dieser Funktion nicht geändert werden.

DateiMuster

Typ: Zeichenkette

Wenn 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.

Modus

Typ: Zeichenkette

Wenn dieser Parameter weggelassen wird oder leer ist, werden nur Dateien einbezogen und Unterverzeichnisse nicht rekursiv durchwandert. Andernfalls geben Sie einen oder mehrere der folgenden Buchstaben an:

• D = Verzeichnisse (Ordner) einbeziehen.
• F = Dateien einbeziehen. Wenn sowohl F als auch D weggelassen werden, werden nur Dateien einbezogen, keine Ordner.
• R = 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. Wenn R weggelassen wird, werden Dateien und Ordner in den Unterordnern nicht mit einbezogen.

Fehlerbehandlung

Es wird ein Error ausgelöst, wenn Dateien nicht geändert werden konnten, wobei dessen Extra-Eigenschaft die Anzahl der Misserfolge enthält.

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\*.*", "DF"  ; +RH ist identisch mit +R+H

FileSetAttrib "^H", "C:\MeineDateien"

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

FileSetAttrib "+A", "C:\*.ini", "R"