Función CfReportSyncStatus (cfapi.h)

Permite a un proveedor de sincronización notificar a la plataforma su estado en una raíz de sincronización especificada sin tener que conectarse con una llamada a CfConnectSyncRoot primero.

Sintaxis

HRESULT CfReportSyncStatus(
  [in, out] LPCWSTR        SyncRootPath,
  [in]      CF_SYNC_STATUS *SyncStatus
);

Parámetros

[in, out] SyncRootPath

Ruta de acceso a la raíz de sincronización.

[in] SyncStatus

Estado de sincronización que se va a notificar; si NULLes , borra el estado de sincronización guardado anteriormente. Para obtener más información, vea la sección Comentarios , a continuació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

Cuando se proporciona un CF_SYNC_STATUS distinto de null en el parámetro SyncStatus , la información se recordará en la raíz de sincronización hasta que el proveedor de sincronización lo borre explícitamente o cuando se reinicie la máquina. La plataforma consultará esta información sobre las operaciones con errores en un marcador de posición de archivo en la nube mediante el siguiente proceso:

1. La plataforma buscará primero el estado de sincronización en el nivel de archivo.
2. Si no se encuentra ningún estado de sincronización, la plataforma buscará el estado de sincronización registrado en el nivel raíz de sincronización, que se realiza a través de esta función.
3. Una vez que se encuentra un estado de sincronización, la plataforma usará la información proporcionada para construir un mensaje más significativo y accionable al usuario.

CfReportSyncStatus borra el estado de sincronización guardado anteriormente cuando se llama con un NULL estado de sincronización. No se realizará ningún cambio en el estado de sincronización existente si se produce un error en la llamada de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1803 [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

Consulte también

CfConnectSyncRoot

CF_SYNC_STATUS