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 прекращает обработку текущего пакета изменений и возвращает код ошибки из метода ProcessChangeBatch интерфейса IFileSyncProvider.