CfUnregisterSyncRoot, fonction (cfapi.h)

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.

Configuration requise

Voir aussi

CfRegisterSyncRoot