Partager via

CfUnregisterSyncRoot, fonction (cfapi.h)

  • Article

Annule l’inscription d’une racine de synchronisation précédemment inscrite.

Syntaxe

HRESULT CfUnregisterSyncRoot(
  [in] LPCWSTR SyncRootPath
);

Paramètres

[in] SyncRootPath

Chemin d’accès à la racine de synchronisation à désinscrire.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .

Notes

Annule l’inscription d’une racine de synchronisation inscrite auprès de CfRegisterSyncRoot. Cela est généralement appelé au moment de la désinstallation du fournisseur de synchronisation, lorsqu’un compte d’utilisateur est supprimé ou lorsqu’un utilisateur choisit de ne plus synchroniser une arborescence d’annuaires (si le fournisseur de synchronisation le prend en charge). Si la racine de synchronisation à désinscrire n’a jamais été inscrite auparavant, l’API échoue avec STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT.

Le fournisseur de synchronisation doit avoir WRITE_DATA ou WRITE_DAC accès à la racine de synchronisation pour être désinscrit, sinon la désinscription échoue avec HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED). La désinscription échoue également avec HRESULT(ERROR_CLOUD_FILE_INVALID_REQUEST) si un fournisseur de synchronisation est connecté à la racine de synchronisation.

Annule l’inscription d’une racine de synchronisation en parcourant l’arborescence de répertoires de la racine de synchronisation.

Pour les fichiers d’espace réservé :

  • Si un fichier d’espace réservé est entièrement hydraté, il est rétabli en fichier « normal ».
  • Si un fichier d’espace réservé n’est pas hydraté, il est définitivement supprimé de l’ordinateur local.

Pour les répertoires d’espaces réservés :

  • Si un répertoire d’espace réservé est entièrement rempli, il est rétabli en répertoire « normal ».
  • Si un répertoire d’espace réservé n’est pas entièrement rempli, le répertoire est définitivement supprimé de l’ordinateur local.

Notes

Si les fichiers d’espace réservé ou les répertoires ne peuvent pas être restaurés ou supprimés, ils sont ignorés et le processus de désinscription se poursuit jusqu’à ce que l’arborescence racine de synchronisation complète ait été parcourue.

Configuration requise

   
Client minimal pris en charge Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 [applications de bureau uniquement]
Plateforme cible Windows
En-tête cfapi.h
Bibliothèque CldApi.lib
DLL CldApi.dll

Voir aussi

CfRegisterSyncRoot