Função CfUnregisterSyncRoot (cfapi.h)

  • Artigo

Cancela o registro de uma raiz de sincronização registrada anteriormente.

Sintaxe

HRESULT CfUnregisterSyncRoot(
  [in] LPCWSTR SyncRootPath
);

Parâmetros

[in] SyncRootPath

O caminho para a raiz de sincronização a ser cancelado.

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

Cancela o registro de uma raiz de sincronização que foi registrada com CfRegisterSyncRoot. Normalmente, isso é chamado no momento da desinstalação do provedor de sincronização, quando uma conta de usuário é excluída ou quando um usuário opta por não sincronizar mais uma árvore de diretório (se houver suporte do provedor de sincronização). Se a raiz de sincronização a ser não registrada nunca tiver sido registrada antes, a API falhará com STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT.

O provedor de sincronização deve ter WRITE_DATA ou WRITE_DAC acesso à raiz de sincronização para não ser registrado ou o cancelamento do registro falhará com HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED). O cancelamento do registro também falhará com HRESULT(ERROR_CLOUD_FILE_INVALID_REQUEST) se um provedor de sincronização estiver conectado à raiz de sincronização.

Cancela o registro de uma raiz de sincronização percorrendo a árvore de diretório da raiz de sincronização.

Para arquivos de espaço reservado:

  • Se um arquivo de espaço reservado estiver totalmente hidratado, ele será revertido para um arquivo "normal".
  • Se um arquivo de espaço reservado não estiver hidratado, ele será excluído permanentemente do computador local.

Para diretórios de espaço reservado:

  • Se um diretório de espaço reservado estiver totalmente preenchido, ele será revertido para um diretório "normal".
  • Se um diretório de espaço reservado não estiver totalmente preenchido, o diretório será excluído permanentemente do computador local.

Observação

Se os arquivos ou diretórios de espaço reservado não puderem ser revertidos ou excluídos, ele será ignorado e o processo de cancelamento do registro continuará até que a árvore raiz de sincronização completa seja percorrida.

Requisitos

   
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

CfRegisterSyncRoot