SetFileAttributesFromAppW-Funktion (fileapifromapp.h)

Legt die Attribute für eine Datei oder ein Verzeichnis fest. Das Verhalten dieser Funktion ist identisch mit SetFileAttributes, mit der Ausnahme, dass diese Funktion dem Universelle Windows-Plattform App-Sicherheitsmodell entspricht.

Syntax

WINSTORAGEAPI BOOL SetFileAttributesFromAppW(
  LPCWSTR lpFileName,
  DWORD   dwFileAttributes
) noexcept;

Parameter

lpFileName

Der Name der Datei, deren Attribute festgelegt werden sollen.

Weitere Informationen zum Deaktivieren der MAX_PATH Einschränkung ohne Vorheriges "\\?\" finden Sie im Abschnitt "Maximale Pfadlängenbegrenzung" unter Benennungsdateien, Pfade und Namespaces .

dwFileAttributes

Die Dateiattribute, die für die Datei festgelegt werden sollen.

Bei diesem Parameter kann es sich um einen oder mehrere Werte handeln, die mit dem bitweisen OR-Operator kombiniert werden. Alle anderen Werte überschreiben jedoch FILE_ATTRIBUTE_NORMAL.

Nicht alle Attribute werden von dieser Funktion unterstützt.

Im Folgenden ist eine Liste der unterstützten Attributwerte aufgeführt.

Wert	Bedeutung
FILE_ATTRIBUTE_ARCHIVE 32 (0x20)	Eine Datei oder ein Verzeichnis, bei dem es sich um eine Archivdatei oder ein Verzeichnis handelt. Anwendungen verwenden dieses Attribut in der Regel, um Dateien für die Sicherung oder Entfernung zu markieren.
FILE_ATTRIBUTE_HIDDEN 2 (0x2)	Die Datei oder das Verzeichnis ist versteckt. Die Datei ist ausgeblendet und daher nicht in einer normalen Verzeichnisliste enthalten.
FILE_ATTRIBUTE_NORMAL 128 (0x80)	Eine Datei, für die keine anderen Attribute festgelegt sind. Dieses Attribut ist nur gültig, wenn es allein verwendet wird.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192 (0x2000)	Die Datei oder das Verzeichnis darf nicht vom Inhaltsindizierungsdienst indiziert werden.
FILE_ATTRIBUTE_OFFLINE 4096 (0x1000)	Die Daten einer Datei sind nicht sofort verfügbar. Dieses Attribut gibt an, dass die Dateidaten physisch in den Offlinespeicher verschoben werden. Dieses Attribut wird von Remotespeicher verwendet, bei der es sich um die hierarchische Speicherverwaltungssoftware handelt. Anwendungen sollten dieses Attribut nicht willkürlich ändern.
FILE_ATTRIBUTE_READONLY 1 (0x1)	Eine Datei, die schreibgeschützt ist. Anwendungen können die Datei lesen, aber nicht in sie schreiben oder löschen. Dieses Attribut wird in Verzeichnissen nicht berücksichtigt.
FILE_ATTRIBUTE_SYSTEM 4 (0x4)	Eine Datei oder ein Verzeichnis, teilweise oder ausschließlich vom Betriebssystem verwendet.
FILE_ATTRIBUTE_TEMPORARY 256 (0x100)	Eine Datei, die für die temporäre Speicherung verwendet wird. Dateisysteme vermeiden das Zurückschreiben von Daten in den Massenspeicher, wenn genügend Cachespeicher verfügbar ist, da in der Regel eine Anwendung eine temporäre Datei löscht, nachdem das Handle geschlossen wurde. In diesem Szenario kann das System das Schreiben der Daten vollständig vermeiden. Andernfalls werden die Daten geschrieben, nachdem das Handle geschlossen wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 10, Version 1803
Kopfzeile	fileapifromapp.h