Condividi tramite

Funzione CfReportSyncStatus (cfapi.h)

  • Articolo

Consente a un provider di sincronizzazione di inviare prima una notifica alla piattaforma dello stato in una radice di sincronizzazione specificata senza dover connettersi con una chiamata a CfConnectSyncRoot .

Sintassi

HRESULT CfReportSyncStatus(
  [in, out] LPCWSTR        SyncRootPath,
  [in]      CF_SYNC_STATUS *SyncStatus
);

Parametri

[in, out] SyncRootPath

Percorso della radice di sincronizzazione.

[in] SyncStatus

Stato di sincronizzazione per segnalare; se NULL, cancella lo stato di sincronizzazione salvato in precedenza. Per altre informazioni, vedere la sezione Osservazioni , di seguito.

Valore restituito

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

Commenti

Quando viene fornito un CF_SYNC_STATUS non Null nel parametro SyncStatus , le informazioni verranno ricordate nella radice di sincronizzazione finché non viene cancellata in modo esplicito dal provider di sincronizzazione o quando il computer viene riavviato. La piattaforma esegue una query su tutte le operazioni non riuscite su un segnaposto file cloud usando il processo seguente:

  1. La piattaforma cerca prima lo stato di sincronizzazione a livello di file.
  2. Se non viene trovato alcun stato di sincronizzazione, la piattaforma cercherà lo stato di sincronizzazione registrato a livello radice di sincronizzazione, che viene eseguito tramite questa funzione.
  3. Una volta che si trova uno stato di sincronizzazione, la piattaforma userà le informazioni fornite per costruire un messaggio più significativo e utilizzabile per l'utente.

CfReportSyncStatus cancella lo stato di sincronizzazione salvato in precedenza quando viene chiamato con uno NULL stato di sincronizzazione. Se la chiamata alla funzione non riesce, non verrà apportata alcuna modifica allo stato di sincronizzazione esistente.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 1803 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione cfapi.h
Libreria CldApi.lib
DLL CldApi.dll

Vedi anche

CfConnectSyncRoot

CF_SYNC_STATUS