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

Отключает канал связи, созданный cfConnectSyncRoot.

Синтаксис

HRESULT CfDisconnectSyncRoot(
  [in] CF_CONNECTION_KEY ConnectionKey
);

Параметры

[in] ConnectionKey

Ключ подключения, возвращенный cfConnectSyncRoot , который теперь используется для отключения корня синхронизации.

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

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

Комментарии

Это приведет к удалению канала связи с платформой, которая была ранее создана с помощью CfConnectSyncRoot.

Поставщик синхронизации по-прежнему может получать обратные вызовы во время вызова CfDisconnectSyncRoot , и поставщик может выбрать, нужно ли завершить вызов сбоем или его обслуживанием. Любой из этих вариантов не приведет к перебоям в работе поставщика синхронизации.

После возврата вызова CfDisconnectSyncRoot поставщик синхронизации больше не будет получать обратные вызовы, и платформа завершит сбой любой операции, которая зависит от указанных обратных вызовов.

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

Требования

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

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

CfConnectSyncRoot