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 Plus- (+), Minus- (-) oder Zirkumflexsymbol (^) 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)

Wenn kein Symbol vor den Attributbuchstaben steht, werden die Attribute der Datei mit den angegebenen Attributen ersetzt. Siehe Beispiel #5. Um alle Attribute zu entfernen, verwenden Sie nur "N".

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.

Bemerkungen

Der Komprimierungsstatus von Dateien kann mit dieser Funktion nicht geändert werden.

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"

FileSetAttrib(FileGetAttrib(Datei2), Datei1)