CF_SYNC_STATUS struttura (cfapi.h)

Usato in una struttura CF_OPERATION_INFO per descrivere lo stato di una radice di sincronizzazione specificata.

Sintassi

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

Members

StructSize

Dimensioni, in byte, della struttura di stato di sincronizzazione, inclusa la stringa di descrizione effettiva.

Code

L'uso di questo parametro è completamente fino al provider di sincronizzazione che supporta questo costrutto di stato di sincronizzazione avanzato.

Per un determinato provider di sincronizzazione, si prevede che sia presente un mapping 1:1 tra il codice e la stringa di descrizione.

È consigliabile usare l'ordine di bit più alto per descrivere il tipo di codice di errore: 1 per un codice a livello di errore e 0 per un codice a livello di informazioni.

DescriptionOffset

Offset della stringa di descrizione rispetto all'inizio di CF_SYNC_STATUS. Punta a una stringa con terminazione null localizzata che deve contenere informazioni più significative e gestibili sul file in questione. I provider di sincronizzazione devono bilanciare il requisito di fornire informazioni più azioni e mantenere un footprint di memoria il più piccolo possibile.

DescriptionLength

Dimensioni della stringa di descrizione, in byte, che include il terminatore Null.

DeviceIdOffset

Offset di un BLOB ID dispositivo relativo all'inizio di CF_SYNC_STATUS. Il BLOB id dispositivo è facoltativo e opaco alla piattaforma. Il BLOB deve essere univoco per ogni dispositivo. Se specificato, il BLOB verrà raccolto come parte dei dati di telemetria della piattaforma per diagnosticare i problemi tecnici.

DeviceIdLength

Dimensioni del BLOB ID dispositivo, in byte.

Commenti

Se un puntatore Null è impostato nel campo SyncStatus di una struttura CF_OPERATION_INFO , la piattaforma cancella lo stato di sincronizzazione impostato in precedenza, se presente.

Requisiti

Vedi anche

CF_OPERATION_INFO