CF_HYDRATION_POLICY_PRIMARY-Enumeration (cfapi.h)

  • Artikel

Ermöglicht einem Synchronisierungsanbieter, zu steuern, wie Platzhalterdateien von der Plattform hydratisiert werden sollen. Dies ist die primäre Richtlinie.

Warnung

CF_HYDRATION_POLICY_PARTIAL Richtlinie wird derzeit nicht unterstützt.

Syntax

typedef enum CF_HYDRATION_POLICY_PRIMARY {
  CF_HYDRATION_POLICY_PARTIAL = 0,
  CF_HYDRATION_POLICY_PROGRESSIVE = 1,
  CF_HYDRATION_POLICY_FULL = 2,
  CF_HYDRATION_POLICY_ALWAYS_FULL = 3
} ;

Konstanten

 
CF_HYDRATION_POLICY_PARTIAL
Wert: 0
Das gleiche Verhalten wie CF_HYDRATION_POLICY_PROGRESSIVE, mit der Ausnahme, dass CF_HYDRATION_POLICY_PARTIAL keine kontinuierliche Hydratation im Hintergrund aufweist.
CF_HYDRATION_POLICY_PROGRESSIVE
Wert: 1
Wenn CF_HYDRATION_POLICY_PROGRESSIVE ausgewählt ist, kann auf der Plattform ein Platzhalter dehydriert werden. Wenn die Plattform den Zugriff auf einen dehydrierten Platzhalter erkennt, führt sie die Benutzer-E/A-Anforderung aus, sobald sie feststellt, dass genügend Daten vom Synchronisierungsanbieter empfangen werden. Die Plattform fordert jedoch weiterhin den verbleibenden Inhalt im Platzhalter vom Synchronisierungsanbieter im Hintergrund an, bis entweder der vollständige Inhalt des Platzhalters lokal verfügbar ist oder der letzte Benutzerhandle für den Platzhalter geschlossen ist.

HINWEIS
Synchronisierungsanbieter, die sich für CF_HYDRATION_POLICY_PROGRESSIVE entscheiden, gehen möglicherweise nicht davon aus, dass Hydrationsrückrufe sequenziell von Offset 0 eintreffen. Mit anderen Worten: Von Synchronisierungsanbietern mit CF_HYDRATION_POLICY_PROGRESSIVE Richtlinie wird erwartet, dass sie zufällige Suchvorgänge auf dem Platzhalter verarbeiten.
CF_HYDRATION_POLICY_FULL
Wert: 2
Wenn CF_HYDRATION_POLICY_FULL ausgewählt wird, ermöglicht die Plattform das Dehydrieren eines Platzhalters. Wenn die Plattform den Zugriff auf einen dehydrierten Platzhalter erkennt, stellt sie sicher, dass der vollständige Inhalt des Platzhalters lokal verfügbar ist, bevor die Benutzer-E/A-Anforderung abgeschlossen wird, auch wenn die Anforderung nur 1 Byte verlangt.
CF_HYDRATION_POLICY_ALWAYS_FULL
Wert: 3
Wenn CF_HYDRATION_POLICY_ALWAYS_FULL ausgewählt ist, blockiert die Plattform jeden Platzhaltervorgang, der zu einem nicht vollständig hydratisierten Platzhalter führen könnte, der CfCreatePlaceholders, CfUpdatePlaceholder mit der Dehydrate-Option und CfConvertToPlaceholder mit der Dehydrierungsoption umfasst.

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

Weitere Informationen

CfCreatePlaceholders

CfUpdatePlaceholder

CfConvertToPlaceholder