Freigeben über

CF_UPDATE_FLAGS-Enumeration (cfapi.h)

  • Artikel

Flags zum Aktualisieren einer Platzhalterdatei oder eines Verzeichnisses.

Syntax

typedef enum CF_UPDATE_FLAGS {
  CF_UPDATE_FLAG_NONE,
  CF_UPDATE_FLAG_VERIFY_IN_SYNC,
  CF_UPDATE_FLAG_MARK_IN_SYNC,
  CF_UPDATE_FLAG_DEHYDRATE,
  CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY,
  CF_UPDATE_FLAG_CLEAR_IN_SYNC,
  CF_UPDATE_FLAG_REMOVE_PROPERTY,
  CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA,
  CF_UPDATE_FLAG_ALWAYS_FULL,
  CF_UPDATE_FLAG_ALLOW_PARTIAL
} ;

Konstanten

 
CF_UPDATE_FLAG_NONE
0x00000000

Keine Updateflags.
CF_UPDATE_FLAG_VERIFY_IN_SYNC
0x00000001

Das Update schlägt fehl, wenn das attribut CF_UPDATE_FLAG_MARK_IN_SYNC derzeit nicht für den Platzhalter festgelegt ist. Dadurch soll verhindert werden, dass änderungen aus der Cloud mit einem lokalen Platzhalter synchronisiert werden und der Datenstrom des Platzhalters lokal geändert wird.
CF_UPDATE_FLAG_MARK_IN_SYNC
0x00000002

Die Plattform markiert den Platzhalter bei einem erfolgreichen Aktualisierungsplatzhaltervorgang als synchron.
CF_UPDATE_FLAG_DEHYDRATE
0x00000004

Gilt nur für Dateien. Wenn angegeben, dehydriert die Plattform die Datei, nachdem der Platzhalter erfolgreich aktualisiert wurde. Der Aufrufer muss bei der Angabe dieses Flags ein exklusives Handle abrufen, da sonst Datenbeschädigungen auftreten können. Beachten Sie, dass die Plattform die Exklusivität des Handles nicht überprüft.
CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION
0x00000008

Gilt nur für Verzeichnisse. Wenn angegeben, markiert es das aktualisierte Platzhalterverzeichnis teilweise aufgefüllt, sodass jeder zukünftige Zugriff darauf zu einem FETCH_PLACEHOLDERS Rückruf führt, der an den Synchronisierungsanbieter gesendet wird.
CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION
0x00000010

Gilt nur für Verzeichnisse. Wenn angegeben, markiert es das aktualisierte Platzhalterverzeichnis vollständig aufgefüllt, sodass jeder zukünftige Zugriff darauf von der Plattform ohne Rückrufe an den Synchronisierungsanbieter verarbeitet wird.
CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY
0x00000020

Wenn angegeben, werden FileIdentity und FileIdentityLength in CfUpdatePlaceholder ignoriert, und die Plattform entfernt das vorhandene Dateiidentitätsblob auf dem Platzhalter nach einem erfolgreichen Updateaufruf.
CF_UPDATE_FLAG_CLEAR_IN_SYNC
0x00000040

Die Plattform markiert den Platzhalter bei einem erfolgreichen Updateplatzhaltervorgang als nicht synchronisiert.
CF_UPDATE_FLAG_REMOVE_PROPERTY
0x00000080

Die Plattform entfernt alle vorhandenen extrinsischen Eigenschaften für den Platzhalter.

HINWEIS

Dieser Wert ist in Windows 10, Version 1803 und höher, verfügbar.
CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA
0x00000100

Die Plattform übergibt CF_FS_METADATA ohne Jegliche Filterung an das Dateisystem. Andernfalls überspringt die Plattform das Festlegen von Feldern, deren Wert 0 ist.

HINWEIS

Dieser Wert ist in Windows 10, Version 1803 und höher, verfügbar.
CF_UPDATE_FLAG_ALWAYS_FULL
0x00000200

CF_UPDATE_FLAG_ALWAYS_FULL gilt nur für Platzhalterdateien. Wenn angegeben, wird der zu aktualisierende Platzhalter als immer voll markiert. Nach dem Aktivieren schlägt jeder Versuch, eine solche Platzhalterdatei zu deaktivieren, mit dem Fehlercode ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWEDfehl.
CF_UPDATE_FLAG_ALLOW_PARTIAL
0x00000400

CF_UPDATE_FLAG_ALLOW_PARTIAL gilt nur für Platzhalterdateien. Wenn angegeben, wird der immer vollständige Zustand einer Platzhalterdatei gelöscht, sofern vorhanden, sodass sie wieder dehydriert werden kann. Es ist ungültig, dieses Flag zusammen mit CF_UPDATE_FLAG_ALWAYS_FULL anzugeben, und der Fehlercode ERROR_CLOUD_FILE_INVALID_REQUEST wird als Ergebnis zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Kopfzeile cfapi.h

Weitere Informationen

CfUpdatePlaceholder