cfReportSyncStatus 函数 (cfapi.h)

允许同步提供程序在指定的同步根上通知平台其状态，而无需先通过调用 CfConnectSyncRoot 进行连接。

语法

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

[in, out] SyncRootPath

同步根目录的路径。

[in] SyncStatus

要报告的同步状态;如果 NULL为，则清除以前保存的同步状态。有关详细信息，请参阅下面的 “备注 ”部分。

如果此函数成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

如果 SyncStatus 参数中提供了非 null CF_SYNC_STATUS，则会在同步根上记住该信息，直到同步提供程序显式清除该信息或计算机重新启动为止。平台将使用以下过程在云文件占位符上执行任何失败的操作时查询此信息：

使用同步状态调用时，CfReportSyncStatus 会清除以前保存的NULL同步状态。如果函数调用失败，将不会对现有同步状态进行更改。