CF_UPDATE_FLAGS-Enumeration (cfapi.h)

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