Función CfSetInSyncState (cfapi.h)

  • Artículo

Establece el estado en sincronización de un archivo o carpeta de marcador de posición.

Sintaxis

HRESULT CfSetInSyncState(
  [in]                HANDLE               FileHandle,
  [in]                CF_IN_SYNC_STATE     InSyncState,
  [in]                CF_SET_IN_SYNC_FLAGS InSyncFlags,
  [in, out, optional] USN                  *InSyncUsn
);

Parámetros

[in] FileHandle

Identificador del marcador de posición. La plataforma sincroniza correctamente la operación con otras solicitudes activas. Un atributo o un identificador de acceso no es suficiente. El autor de la llamada debe tener acceso WRITE_DATA o WRITE_DAC al marcador de posición.

[in] InSyncState

Estado en sincronización. InSyncState se puede establecer en uno de los siguientes valores:

  • Si se especifica CF_IN_SYNC_STATE_NOT_IN_SYNC , la plataforma borra el estado sincronizado del marcador de posición tras una devolución correcta de la llamada API.
  • Si se especifica CF_IN_SYNC_STATE_IN_SYNC , la plataforma establece el estado de sincronización del marcador de posición tras una devolución correcta de la llamada API.

[in] InSyncFlags

Marcas de estado en sincronización. Consulte CF_SET_IN_SYNC_FLAGS para obtener más detalles.

[in, out, optional] InSyncUsn

Cuando se especifica, en la entrada, InSyncUsn indica a la plataforma que solo realice la configuración de sincronización si el archivo sigue teniendo el mismo valor USN que el pasado. Esto es para cerrar una carrera en la que el proveedor de sincronización acaba de cambiar el marcador de posición de sincronización hasta la nube, pero antes de la llamada a CfSetInSyncState, el marcador de posición cambió de alguna manera. Pasar un puntero a un valor USN de 0 en la entrada es el mismo que pasar un NULL puntero. Al devolver, InSYncUsn recibe el valor de USN final después de establecer el estado en 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.

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

Consulte también

CF_IN_SYNC_STATE

CF_SET_IN_SYNC_FLAGS