Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Annulla la registrazione di una radice di sincronizzazione registrata in precedenza.
Sintassi
HRESULT CfUnregisterSyncRoot(
[in] LPCWSTR SyncRootPath
);
Parametri
[in] SyncRootPath
Percorso della radice di sincronizzazione da annullare la registrazione.
Valore restituito
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Annulla la registrazione di una radice di sincronizzazione registrata con CfRegisterSyncRoot. Questo viene in genere chiamato al momento della disinstallazione del provider di sincronizzazione, quando un account utente viene eliminato o quando un utente sceglie di non sincronizzare più un albero di directory (se supportato dal provider di sincronizzazione). Se la radice di sincronizzazione da annullare la registrazione non è mai stata registrata prima, l'API non riesce con STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT.
Il provider di sincronizzazione deve avere WRITE_DATA o WRITE_DAC l'accesso alla radice di sincronizzazione da annullare o annullare la registrazione avrà esito negativo con HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED). La registrazione avrà esito negativo anche con HRESULT(ERROR_CLOUD_FILE_INVALID_REQUEST) se un provider di sincronizzazione è connesso alla radice di sincronizzazione.
Annulla la registrazione di una radice di sincronizzazione attraversando l'albero della directory della radice di sincronizzazione.
Per i file segnaposto:
- Se un file segnaposto è completamente idratato, viene ripristinato in un file "normale".
- Se un file segnaposto non è idratato, viene eliminato definitivamente dal computer locale.
Per le directory segnaposto:
- Se una directory segnaposto è completamente popolata, viene ripristinata in una directory "normale".
- Se una directory segnaposto non è completamente popolata, la directory viene eliminata definitivamente dal computer locale.
Nota
Se i file segnaposto o le directory non possono essere ripristinati o eliminati, verrà ignorato e il processo di annullamento della registrazione continuerà fino a quando non è stato superato l'albero radice di sincronizzazione completo.
Requisiti
| Client minimo supportato | Windows 10 versione 1709 [solo app desktop] |
| Server minimo supportato | Windows Server 2016 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | cfapi.h |
| Libreria | CldApi.lib |
| DLL | CldApi.dll |