Condividi tramite


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_DISALLOWEDdi 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

Vedi anche

CfUpdatePlaceholder