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, präfixieren Sie einen oder mehrere der folgenden Attributsbuchstaben mit einem Pluszeichen (+), Minuszeichen (-) bzw. Zirkumflex (^):

• 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: Zurzeit kann der Komprimierungsstatus von Dateien mit diesem Befehl nicht geändert werden.

DateiMuster

Name einer Datei oder eines Ordners, oder ein Platzhaltermuster wie C:\Temp\*.tmp. Wenn kein absoluter Pfad angegeben ist, wird DateiMuster im A_WorkingDir-Verzeichnis vermutet.

Lässt man diesen Parameter weg, wird stattdessen die aktuelle Datei von der innersten umschlossenen Datei-Schleife verwendet.

OrdnerEinbeziehen?

Wenn dieser Parameter weggelassen wird oder leer ist, wird standardmäßig 0 (nur Dateien werden mit einbezogen) verwendet. Ansonsten können Sie eine der folgenden Ziffern angeben:

• 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 dieser Parameter weggelassen wird oder leer ist, wird standardmäßig 0 (Unterordner werden nicht rekursiv durchwandert) verwendet. Ansonsten können Sie eine der folgenden Ziffern angeben:

• 0 = Unterordner werden nicht rekursiv durchwandert.
• 1 = Unterordner werden rekursiv durchwandert; das heißt, dass zusätzlich alle tieferen Navigationsebenen des angegebenen Platzhaltermusters durchsucht werden, um Dateien und Ordner zu finden, die dem DateiMuster entsprechen. 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 entweder auf Null (0) oder unmittelbar nach dem letzten Fehler auf das Ergebnis der Systemfunktion GetLastError() gesetzt. Ansonsten 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