Funzione CfSetInSyncState (cfapi.h)

Imposta lo stato di sincronizzazione per un file o una cartella segnaposto.

Sintassi

HRESULT CfSetInSyncState(
  [in]                HANDLE               FileHandle,
  [in]                CF_IN_SYNC_STATE     InSyncState,
  [in]                CF_SET_IN_SYNC_FLAGS InSyncFlags,
  [in, out, optional] USN                  *InSyncUsn
);

Parametri

[in] FileHandle

Handle per il segnaposto. La piattaforma sincronizza correttamente l'operazione con altre richieste attive. È sufficiente un handle di attributo o senza accesso. Il chiamante deve avere WRITE_DATA o WRITE_DAC l'accesso al segnaposto.

[in] InSyncState

Stato di sincronizzazione. InSyncState può essere impostato su uno dei valori seguenti:

• Se viene specificato CF_IN_SYNC_STATE_NOT_IN_SYNC , la piattaforma cancella lo stato di sincronizzazione del segnaposto in caso di esito positivo della chiamata API.
• Se viene specificato CF_IN_SYNC_STATE_IN_SYNC , la piattaforma imposta lo stato di sincronizzazione del segnaposto in caso di esito positivo della chiamata API.

[in] InSyncFlags

Flag di stato in-sync. Per altri dettagli, vedere CF_SET_IN_SYNC_FLAGS .

[in, out, optional] InSyncUsn

Se specificato, in input , InSyncUsn indica alla piattaforma di eseguire l'impostazione di sincronizzazione solo se il file ha ancora lo stesso valore USN di quello passato. Si tratta di chiudere una gara in cui il provider di sincronizzazione ha appena sincronizzato modifiche segnaposto fino al cloud, ma prima della chiamata a CfSetInSyncState, il segnaposto è cambiato in qualche modo. Il passaggio di un puntatore a un valore USN di 0 su input equivale al passaggio di un NULL puntatore. In caso di restituzione, InSYncUsn riceve il valore USN finale dopo l'impostazione dello stato di sincronizzazione.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Vedi anche

CF_IN_SYNC_STATE

CF_SET_IN_SYNC_FLAGS