CF_CONVERT_FLAGS-Enumeration (cfapi.h)

  • Artikel

Normale Datei/Verzeichnis zu Platzhalterdatei/Verzeichniskonvertierungsflags.

Syntax

typedef enum CF_CONVERT_FLAGS {
  CF_CONVERT_FLAG_NONE = 0x00000000,
  CF_CONVERT_FLAG_MARK_IN_SYNC = 0x00000001,
  CF_CONVERT_FLAG_DEHYDRATE = 0x00000002,
  CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION = 0x00000004,
  CF_CONVERT_FLAG_ALWAYS_FULL = 0x00000008,
  CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE = 0x00000010
} ;

Konstanten

 
CF_CONVERT_FLAG_NONE
Wert: 0x00000000
Keine Konvertierungsflags.
CF_CONVERT_FLAG_MARK_IN_SYNC
Wert: 0x00000001
Die Plattform markiert den konvertierten Platzhalter als synchron mit der Cloud, wenn die Datei erfolgreich konvertiert wurde.
CF_CONVERT_FLAG_DEHYDRATE
Wert: 0x00000002
Gilt nur für Dateien. Bei Angabe dehydriert die Plattform die Datei, nachdem sie erfolgreich in einen Platzhalter konvertiert wurde. Der Aufrufer muss ein exklusives Handle abrufen, wenn dieses Flag angegeben wird, da datenbeschädigungen auftreten können. Beachten Sie, dass die Plattform die Exklusivität des Handles nicht überprüft.
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION
Wert: 0x00000004
Gilt nur für Verzeichnisse. Wenn angegeben, markiert es das konvertierte Platzhalterverzeichnis als teilweise aufgefüllt, sodass jeder zukünftige Zugriff darauf zu einem FETCH_PLACEHOLDERS Rückruf führt, der an den Synchronisierungsanbieter gesendet wird.
CF_CONVERT_FLAG_ALWAYS_FULL
Wert: 0x00000008
Wenn dieses Flag vorhanden ist, wird der neu erstellte Platzhalter als immer voll markiert. Nach der Hydratisierung schlägt jeder Versuch, einen solchen (Datei-)Platzhalter zu dehydrieren, mit fehlercode ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED fehl. Dieses Flag wird nur für eine Platzhalterdatei erzwungen. Sie kann für ein Platzhalterverzeichnis festgelegt werden, hat aber keine Auswirkung.
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE
Wert: 0x00000010
Bei Angabe ermöglicht die Plattform einer Synchronisierungs-Engine das atomare Konvertieren eines Platzhalters für Nicht-Clouddateien (mit einem anderen Reparse-Tag/Daten) in einen Platzhalter für Clouddateien. Beachten Sie, dass bei der API normalerweise die Konvertierung einer Nicht-Platzhalterdatei in einen Platzhalter fehlschlägt.

Die Kombination **(CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE		 CF_CONVERT_FLAG_DEHYDRATE)** ist besonders nützlich in Migrationsszenarien, wenn bestimmte Anbieter von einer anderen Plattform zur Clouddateiplattform migrieren und hydratisierte Platzhalter auf der älteren Plattform in dehydrierte Platzhalter auf der Clouddateien-Plattform atomar konvertieren möchten. Nur dieses Flag sollte zum Konvertieren vollständiger Platzhalter in Clouddateien-Platzhalter übergeben werden. Wenn die ältere Plattform vollständige Dateien als reguläre Dateien ohne Platzhalter implementiert, ist dieses Flag nicht erforderlich. Durch das Übergeben dieses Flags für ein Verzeichnis werden Auch Verzeichnisse in Clouddateien konvertiert, obwohl das DEHYDRATE-Flag nicht für Verzeichnisse gilt.

Selbst wenn die Richtlinie CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_TO_UNRESTRICTED mit CfRegisterSyncRoot angegeben wurde, dürfen nur Prozesse, die mit dem Synchronisierungsstamm der Clouddateien registriert/verbunden sind, dieses Flag angeben.

>[! HINWEIS]
>Das Flag wird nur unterstützt, wenn das PlatformVersion.IntegrationNumber von CfGetPlatformInfo abgerufene oder höher ist 0x500 .

Anforderungen

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

Siehe auch

CfConvertToPlaceholder

CfRegisterSyncRoot

CfGetPlatformInfo