Função CfUnregisterSyncRoot (cfapi.h)

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.

Requisitos

Confira também

CfRegisterSyncRoot