IFileSyncProviderCallback::OnChangeApplied
在应用文件变更后发生。
HRESULT OnChangeApplied(
LPCWSTR pcszNewFilePath,
LPCWSTR pcszOldFilePath,
DWORD dwChangeType);
参数
- pcszNewFilePath
[in, string] 已变更的文件的新路径。该路径是相对于根目录的。如果 dwChangeType 为 FILESYNC_CHANGE_TYPE_RENAME,则此值为应用新名称之后的新路径。如果 dwChangeType 为 FILESYNC_CHANGE_TYPE_DELETE,则此值为 NULL。
- pcszOldFilePath
[in, string] 已变更的文件的先前路径。该路径是相对于根目录的。如果 dwChangeType 为 FILESYNC_CHANGE_TYPE_RENAME,则此值为应用新名称之前的先前路径。如果 dwChangeType 为 FILESYNC_CHANGE_TYPE_CREATE,则此值为 NULL。
- dwChangeType
[in] 已应用的变更的类型。此值来自 FILESYNC_CHANGE_TYPE 枚举。
返回值
- S_OK
备注
此事件仅在变更影响目标副本的文件数据时引发,而不会在变更仅影响文件的元数据时引发。例如,如果检测到更新-更新冲突且目标系统上的文件被选为入选方,则不会对目标应用任何变更,并且不激发此事件。同样,将逻辑删除从源传播到目标会导致仅更新元数据,而不会对目标文件系统进行任何变更。在这种情况下,将不激发此事件。
如果 OnChangeApplied 返回一个错误,则 Sync Framework 会停止当前的变更批,并从 IFileSyncProvider 的 ProcessChangeBatch 方法返回错误。