enumerazione CF_UPDATE_FLAGS (cfapi.h)
Flag per l'aggiornamento di un file segnaposto o una directory.
Sintassi
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
} ;
Costanti
CF_UPDATE_FLAG_NONE 0x00000000 Nessun flag di aggiornamento. |
CF_UPDATE_FLAG_VERIFY_IN_SYNC 0x00000001 L'aggiornamento avrà esito negativo se l'attributo CF_UPDATE_FLAG_MARK_IN_SYNC non è attualmente impostato sul segnaposto. Si tratta di impedire una corsa tra le modifiche di sincronizzazione dal cloud verso il basso a un segnaposto locale e il flusso di dati del segnaposto che viene modificato in locale. |
CF_UPDATE_FLAG_MARK_IN_SYNC 0x00000002 La piattaforma contrassegna il segnaposto come in-sync dopo un'operazione segnaposto di aggiornamento riuscita. |
CF_UPDATE_FLAG_DEHYDRATE 0x00000004 Applicabile solo ai file. Se specificato, la piattaforma disidrata il file dopo aver aggiornato correttamente il segnaposto. Il chiamante deve acquisire un handle esclusivo quando si specifica questo flag o danneggiamento dei dati può verificarsi. Si noti che la piattaforma non convalida l'esclusiva dell'handle. |
CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION 0x00000008 Applicabile solo alle directory. Se specificato, contrassegna la directory segnaposto aggiornata parzialmente popolata in modo che qualsiasi accesso futuro a esso comporterà un callback FETCH_PLACEHOLDERS inviato al provider di sincronizzazione. |
CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION 0x00000010 Applicabile solo alle directory. Se specificato, contrassegna la directory segnaposto aggiornata completamente popolata in modo che qualsiasi accesso futuro a esso verrà gestito dalla piattaforma senza alcun callback al provider di sincronizzazione. |
CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY 0x00000020 Se specificato, FileIdentity e FileIdentityLength in CfUpdatePlaceholder vengono ignorati e la piattaforma rimuoverà il BLOB di identità file esistente nel segnaposto dopo una chiamata di aggiornamento riuscita. |
CF_UPDATE_FLAG_CLEAR_IN_SYNC 0x00000040 La piattaforma contrassegna il segnaposto come non sincronizzato dopo un'operazione segnaposto di aggiornamento riuscita. |
CF_UPDATE_FLAG_REMOVE_PROPERTY 0x00000080 La piattaforma rimuove tutte le proprietà extrinsiche esistenti sul segnaposto. NOTA Questo valore è disponibile in Windows 10, versione 1803 e successiva. |
CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA 0x00000100 La piattaforma passa CF_FS_METADATA al file system senza alcun filtro; in caso contrario, la piattaforma ignora l'impostazione di tutti i campi il cui valore è 0. NOTA Questo valore è disponibile in Windows 10, versione 1803 e successiva. |
CF_UPDATE_FLAG_ALWAYS_FULL 0x00000200 CF_UPDATE_FLAG_ALWAYS_FULL è efficace solo nei file segnaposto. Se specificato, il segnaposto da aggiornare è contrassegnato sempre completo. Una volta idratato, qualsiasi tentativo di disidratazione di tale file segnaposto avrà esito negativo con il codice ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED di errore . |
CF_UPDATE_FLAG_ALLOW_PARTIAL 0x00000400 CF_UPDATE_FLAG_ALLOW_PARTIAL è efficace solo nei file segnaposto. Se specificato, lo stato completo sempre in un file segnaposto, se presente, viene cancellato, consentendo così di essere nuovamente disidratato. Non è valido specificare questo flag insieme al CF_UPDATE_FLAG_ALWAYS_FULL codice ERROR_CLOUD_FILE_INVALID_REQUEST di errore e verrà restituito come risultato. |
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 10 versione 1709 [solo app desktop] |
Server minimo supportato | Windows Server 2016 [solo app desktop] |
Intestazione | cfapi.h |