Função CfDisconnectSyncRoot (cfapi.h)

Desconecta um canal de comunicação criado por CfConnectSyncRoot.

Sintaxe

HRESULT CfDisconnectSyncRoot(
  [in] CF_CONNECTION_KEY ConnectionKey
);

Parâmetros

[in] ConnectionKey

A chave de conexão retornada de CfConnectSyncRoot que agora é usada para desconectar a raiz de sincronização.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Isso remove o canal de comunicação com a plataforma que foi estabelecida anteriormente usando CfConnectSyncRoot.

Um provedor de sincronização ainda pode receber retornos de chamada durante a chamada CfDisconnectSyncRoot e o provedor está livre para escolher se a chamada precisa falhar ou ser atendida. Qualquer uma das opções não causará interrupções no provedor de sincronização.

Depois que uma chamada para CfDisconnectSyncRoot retornar, o provedor de sincronização não receberá mais retornos de chamada e a plataforma falhará em qualquer operação que dependa dos retornos de chamada ditos.

Um provedor de sincronização deve ter WRITE_DATA ou WRITE_DAC acesso à raiz de sincronização a ser desconectada ou uma chamada para CfDisconnectSyncRoot falhará com HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED). Além disso, se a raiz de sincronização não tiver sido conectada anteriormente, a chamada falhará com parâmetros inválidos. Essa API pode ser chamada como parte do desligamento normal do provedor de sincronização. No entanto, se o processo do provedor de sincronização optar por terminar sem chamar essa API ou falhar inesperadamente, a plataforma detectará isso e executará a limpeza necessária.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	cfapi.h
Biblioteca	CldApi.lib
DLL	CldApi.dll

Confira também

CfConnectSyncRoot