Функция CfUnregisterSyncRoot (cfapi.h)

Отменяет регистрацию ранее зарегистрированного корневого каталога синхронизации.

Синтаксис

HRESULT CfUnregisterSyncRoot(
  [in] LPCWSTR SyncRootPath
);

Параметры

[in] SyncRootPath

Путь к корневому каталогу синхронизации для отмены регистрации.

Возвращаемое значение

Если эта функция завершается успешно, она возвращает .S_OK В противном случае возвращается код ошибки HRESULT .

Комментарии

Отменяет регистрацию корневого каталога синхронизации, зарегистрированного в CfRegisterSyncRoot. Обычно это вызывается во время удаления поставщика синхронизации, при удалении учетной записи пользователя или при отказе от синхронизации дерева каталогов (если это поддерживается поставщиком синхронизации). Если корневой каталог синхронизации, который требуется отменить, никогда ранее не регистрировался, API завершается сбоем с STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT.

У поставщика синхронизации должен быть WRITE_DATA или WRITE_DAC доступ к корневому каталогу синхронизации, в противном случае отмена регистрации завершится ошибкой HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED). Отмена регистрации также завершится ошибкой HRESULT(ERROR_CLOUD_FILE_INVALID_REQUEST), если поставщик синхронизации подключен к корневому каталогу синхронизации.

Отменяет регистрацию корня синхронизации путем обхода дерева каталогов корня синхронизации.

Для файлов заполнителей:

• Если файл заполнителя полностью гидратирован, он возвращается обратно в "обычный" файл.
• Если файл заполнителя не гидратирован, он окончательно удаляется с локального компьютера.

Для каталогов-заполнителей:

• Если заполнитель полностью заполнен, он возвращается обратно в "обычный" каталог.
• Если заполнитель каталога не заполнен полностью, каталог окончательно удаляется с локального компьютера.

Примечание

Если не удается отменить или удалить файлы заполнителей или каталоги, они будут пропущены, а процесс отмены регистрации будет продолжаться до тех пор, пока не будет пройдено корневое дерево полной синхронизации.

Требования

Минимальная версия клиента	Windows 10 версии 1709 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	cfapi.h
Библиотека	CldApi.lib
DLL	CldApi.dll

См. также раздел

CfRegisterSyncRoot