IFileSyncProviderCallback::OnChangeSkipped
当跳过某个变更时发生。
HRESULT OnChangeSkipped(
LPCWSTR pcszNewFilePath,
LPCWSTR pcszCurrentFilePath,
DWORD dwChangeType,
DWORD dwReason,
HRESULT hrErrorCode);
参数
- pcszNewFilePath
[in, string] 如果应用了变更，文件应具有的新路径。该路径是相对于根目录的。如果 dwChangeType 为 FILESYNC_CHANGE_TYPE_RENAME，则此值为应用新名称之后的路径。如果 dwChangeType 为 FILESYNC_CHANGE_TYPE_DELETE，则此值为 NULL。
- pcszCurrentFilePath
[in, string] 文件的当前路径。该路径是相对于根目录的。如果 dwChangeType 为 FILESYNC_CHANGE_TYPE_RENAME，则此值为应用新名称之前的路径。如果 dwChangeType 为 FILESYNC_CHANGE_TYPE_CREATE，则此值为 NULL。
- dwChangeType
[in] 应该应用的变更的类型。此值来自 FILESYNC_CHANGE_TYPE 枚举。
- dwReason
[in] 无法将变更应用于文件的原因。此值来自 FILESYNC_SKIP_REASON 枚举。
- hrErrorCode
[in] 尝试将变更应用于文件期间由某个函数返回的错误代码（如果已经返回了错误代码）。此参数中包含的错误通常由文件系统返回，以指示应用变更时出现了问题，例如无法获取对文件的写访问权限。
返回值
- S_OK
备注
如果 OnChangeSkipped 返回一个错误，则 Sync Framework 会停止处理当前的变更批，并从 IFileSyncProvider 的 ProcessChangeBatch 方法返回错误代码。