Función CfDisconnectSyncRoot (cfapi.h)
Desconecta un canal de comunicación creado por CfConnectSyncRoot.
Sintaxis
HRESULT CfDisconnectSyncRoot(
[in] CF_CONNECTION_KEY ConnectionKey
);
Parámetros
[in] ConnectionKey
La clave de conexión devuelta de CfConnectSyncRoot que ahora se usa para desconectar la raíz de sincronización.
Valor devuelto
Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Esto quita el canal de comunicación con la plataforma que se estableció anteriormente mediante CfConnectSyncRoot.
Un proveedor de sincronización todavía puede recibir devoluciones de llamada durante la llamada a CfDisconnectSyncRoot y el proveedor es libre de elegir si la llamada debe producir un error o ser servicio. Cualquiera de las opciones no provocará interrupciones en el proveedor de sincronización.
Después de que se devuelva una llamada a CfDisconnectSyncRoot , el proveedor de sincronización ya no recibirá devoluciones de llamada y la plataforma producirá un error en cualquier operación que dependa de dichas devoluciones de llamada.
Un proveedor de sincronización debe tener WRITE_DATA o WRITE_DAC acceso a la raíz de sincronización que se va a desconectar o se producirá un error en una llamada a CfDisconnectSyncRoot con HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED) . Además, si la raíz de sincronización no se ha conectado anteriormente, se producirá un error en la llamada con parámetros no válidos. Se podría llamar a esta API como parte del cierre correcto del proveedor de sincronización. Sin embargo, si el proceso del proveedor de sincronización decide finalizar sin llamar a esta API o se bloquea inesperadamente, la plataforma lo detectará y realizará la limpieza necesaria.
Requisitos
| Requisito | Value |
|---|---|
| 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 |