estructura CF_SYNC_STATUS (cfapi.h)

Se usa en una estructura de CF_OPERATION_INFO para describir el estado de una raíz de sincronización especificada.

Sintaxis

typedef struct CF_SYNC_STATUS {
  ULONG StructSize;
  ULONG Code;
  ULONG DescriptionOffset;
  ULONG DescriptionLength;
  ULONG DeviceIdOffset;
  ULONG DeviceIdLength;
} CF_SYNC_STATUS;

Miembros

StructSize

Tamaño, en bytes, de la estructura de estado de sincronización, incluida la cadena de descripción real.

Code

El uso de este parámetro está completamente al proveedor de sincronización que admite esta construcción de estado de sincronización enriquecida.

Para un proveedor de sincronización determinado, se espera que haya una asignación 1:1 entre el código y la cadena de descripción.

Se recomienda usar el orden de bits más alto para describir el tipo de código de error: 1 para un código de nivel de error y 0 para un código de nivel de información.

Nota

El código es opaco para la plataforma y solo se usa con fines de seguimiento.

DescriptionOffset

Desplazamiento de la cadena de descripción con respecto al inicio de CF_SYNC_STATUS. Apunta a una cadena ancha localizada terminada en null que se espera que contenga información más significativa y accionable sobre el archivo en cuestión. Se espera que los proveedores de sincronización equilibran el requisito de proporcionar información más accionable y mantener una superficie de memoria lo más pequeña posible.

DescriptionLength

Tamaño de la cadena de descripción, en bytes, que incluye el terminador NULL.

DeviceIdOffset

Desplazamiento de un blob de id. de dispositivo con respecto al inicio de CF_SYNC_STATUS. El blob del identificador de dispositivo es opcional y opaco para la plataforma. Se espera que el blob sea único por dispositivo. Si se proporciona, el blob se recopilará como parte de la telemetría de la plataforma para ayudar a diagnosticar problemas técnicos.

DeviceIdLength

Tamaño del blob de id. de dispositivo, en bytes.

Comentarios

Si se establece un puntero nulo en el campo SyncStatus de una estructura de CF_OPERATION_INFO , la plataforma borrará el estado de sincronización establecido anteriormente, si hay uno.

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]
Encabezado	cfapi.h

Consulte también

CF_OPERATION_INFO