Función CfUnregisterSyncRoot (cfapi.h)
Anula el registro de una raíz de sincronización registrada anteriormente.
Sintaxis
HRESULT CfUnregisterSyncRoot(
[in] LPCWSTR SyncRootPath
);
Parámetros
[in] SyncRootPath
Ruta de acceso a la raíz de sincronización que se va a anular el registro.
Valor devuelto
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .
Comentarios
Anula el registro de una raíz de sincronización registrada con CfRegisterSyncRoot. Esto suele llamarse en el momento de desinstalación del proveedor de sincronización, cuando se elimina una cuenta de usuario o cuando un usuario opta por dejar de sincronizar un árbol de directorios (si es compatible con el proveedor de sincronización). Si la raíz de sincronización que se va a anular el registro nunca se ha registrado antes, se produce un error en la API con STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT.
El proveedor de sincronización debe tener WRITE_DATA o WRITE_DAC acceso a la raíz de sincronización que se va a anular el registro o se producirá un error en la anulación del registro con HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED). También se producirá un error en la anulación del registro con HRESULT(ERROR_CLOUD_FILE_INVALID_REQUEST) si un proveedor de sincronización está conectado a la raíz de sincronización.
Anula el registro de una raíz de sincronización mediante el recorrido del árbol de directorios de la raíz de sincronización.
Para los archivos de marcador de posición:
- Si un archivo de marcador de posición está totalmente hidratado, se revierte a un archivo "normal".
- Si un archivo de marcador de posición no está hidratado, se elimina permanentemente del equipo local.
Para los directorios de marcador de posición:
- Si un directorio de marcador de posición se rellena por completo, se revierte a un directorio "normal".
- Si un directorio de marcador de posición no se rellena completamente, el directorio se elimina permanentemente del equipo local.
Nota
Si los archivos o directorios de marcador de posición no se pueden revertir o eliminar, se omitirán y el proceso de anulación del registro continuará hasta que se haya recorrido el árbol raíz de sincronización completa.
Requisitos
| Cliente mínimo compatible | Windows 10, versión 1709 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | cfapi.h |
| Library | CldApi.lib |
| Archivo DLL | CldApi.dll |