CF_HYDRATION_POLICY_MODIFIER-Enumeration (cfapi.h)

Artikel
03/08/2023

Ermöglicht einem Synchronisierungsanbieter, zu steuern, wie Platzhalterdateien von der Plattform hydratisiert werden sollen. Dies ist ein Modifizierer, der mit der primären Richtlinie verwendet werden kann: CF_HYDRATION_POLICY_PRIMARY.

Syntax

typedef enum CF_HYDRATION_POLICY_MODIFIER {
  CF_HYDRATION_POLICY_MODIFIER_NONE,
  CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED,
  CF_HYDRATION_POLICY_MODIFIER_STREAMING_ALLOWED,
  CF_HYDRATION_POLICY_MODIFIER_AUTO_DEHYDRATION_ALLOWED,
  CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION
} ;

Konstanten


`CF_HYDRATION_POLICY_MODIFIER_NONE` `0x0000` Kein Richtlinienmodifizierer.
`CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED` `0x0001` Dieser Richtlinienmodifizierer bietet zwei Garantien für einen Synchronisierungsanbieter. Erstens wird sichergestellt, dass die vom Synchronisierungsanbieter zurückgegebenen Daten immer auf dem Datenträger gespeichert werden, bevor sie an die Benutzeranwendung zurückgegeben werden. Zweitens ermöglicht es dem Synchronisierungsanbieter, dieselben Daten abzurufen, die er zuvor an die Plattform zurückgegeben hat, und ihre Integrität zu überprüfen. Erst nach erfolgreicher Bestätigung der Integrität durch den Synchronisierungsanbieter führt die Plattform die E/A-Anforderung des Benutzers aus. Dieser Modifizierer unterstützt die End-to-End-Datenintegrität auf Kosten zusätzlicher Datenträger-E/A.
`CF_HYDRATION_POLICY_MODIFIER_STREAMING_ALLOWED` `0x0002` Dieser Richtlinienmodifizierer gewährt der Plattform die Berechtigung, keine von einem Synchronisierungsanbieter zurückgegebenen Daten auf lokalen Datenträgern zu speichern. Dieser Richtlinienmodifizierer ist ineffizient, wenn er mit CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED kombiniert wird.
`CF_HYDRATION_POLICY_MODIFIER_AUTO_DEHYDRATION_ALLOWED` `0x0004` Dieser Richtlinienmodifizierer gewährt der Plattform die Berechtigung, Platzhalter für in der Synchronisierung von Clouddateien ohne Hilfe von Synchronisierungsanbietern zu dehydrieren. Ohne dieses Flag darf die Plattform CfDehydratePlaceholder nicht direkt aufrufen. Stattdessen besteht die einzige unterstützte Möglichkeit zum Dehydrieren eines Clouddateiplatzhalters darin, das angeheftete Attribut der Datei zu löschen und das nicht angeheftete Attribut der Datei festzulegen. Zu diesem Zeitpunkt wird die tatsächliche Dehydrierung von der Synchronisierungs-Engine asynchron ausgeführt, nachdem sie die Verzeichnisänderungsbenachrichtigung für die beiden Attribute erhalten hat. Wenn dieses Flag angegeben wird, darf die Plattform CfDehydratePlaceholder direkt auf einem beliebigen Platzhalter in der Synchronisierung der Cloud aufrufen. Es wird empfohlen, dass Synchronisierungsanbieter die automatische Dehydrierung unterstützen. HINWEIS Dieser Wert ist in Windows 10, Version 1803 und höher verfügbar.
`CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION` `0x0008` Dieser Richtlinienmodifizierer gewährt der Plattform die Berechtigung, eine Datei synchron vollständig zu hydratisieren, wenn sie einen Versuch eines AV-Filters abfängt, die Datei zu überprüfen. Synchronisierungsanbieter, die RestartHydration verwenden möchten, um den `fileSize` von einem FetchData-Rückruf zu ändern, müssen sich für die `ALLOW_FULL_RESTART_HYDRATION` Richtlinie anmelden, um mögliche Deadlocks mit Antiviren- und Anti-Malware-Software zu vermeiden, die versucht, die Datei zu überprüfen, und den Anbieter, der versucht, mit RestartHydration zu ändern`fileSize`. HINWEIS Dieses Enumerationsupdate wird nur unterstützt, wenn die `PlatformVersion.IntegrationNumber` von CfGetPlatformInfo abgerufene oder höher ist `0x500` .

Hinweise

Im Allgemeinen können Modifizierer gemischt und mit jeder primären Richtlinie (CF_HYDRATION_POLICY_PRIMARY) und anderen Richtlinienmodifizierern abgeglichen werden, solange die Kombination nicht selbst in Konflikt steht.

Das CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION Flag wird hinzugefügt, um zu verhindern, dass die Funktion "Neustarthydrierung" auf Deadlocks stößt, die durch Anti-Virus- und Malware-Detektoren (AV) verursacht werden. Alle Synchronisierungsanbieter, die beabsichtigen, die Dateigröße einer dehydrierten Datei während des Verlaufs einer Hydration-Anforderung zu aktualisieren, sollten sich für dieses Feature anmelden oder die Hydratation neu starten, kann in einen Deadlock ausgeführt werden, wenn ein AV versucht, eine geöffnete Datei zu überprüfen, indem ein Speicher zugeordneter Abschnitt der Datei erstellt wird, und dies zu Einer Flüssigkeitszufuhr führt. Beachten Sie, dass Anbieter, die Momentaufnahmen oder Versionen einer Datei verwalten und die Anforderung eines Benutzers erfüllen, indem sie die angeforderte Version der Datei bereitstellen, obwohl die Datei im Back-End/Server aktualisiert wurde, diese Richtlinie nicht verwenden müssen. Ebenso können Anbieter, die die Hydrationsanforderung nicht ausführen, falls sich die Datei im Back-End geändert hat, möglicherweise nicht für diese Richtlinie anmelden.

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

CF_HYDRATION_POLICY_PRIMARY

CfDehydratePlaceholder

CfGetPlatformInfo