Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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_NONE0x0000Kein Richtlinienmodifizierer. |
CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED0x0001Dieser 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_ALLOWED0x0002Dieser 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_ALLOWED0x0004Dieser 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_HYDRATION0x0008Dieser 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 ändernfileSize.HINWEIS Dieses Enumerationsupdate wird nur unterstützt, wenn die |
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 |