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 |