CF_SYNC_STATUS 結構 (cfapi.h)

用於 CF_OPERATION_INFO 結構，以描述指定之同步根目錄的狀態。

語法

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

成員

StructSize

同步處理狀態結構的大小，以位元組為單位，包括實際的描述字串。

Code

使用此參數完全由支援此豐富同步狀態建構的同步提供者所組成。

對於特定的同步提供者，預期程式代碼與描述字串之間有1：1對應。

建議您使用最高位順序來描述錯誤碼的類型： 1 針對錯誤層級代碼，以及 0 針對資訊層級程序代碼。

DescriptionOffset

描述字串相對於 CF_SYNC_STATUS開頭的位移。 它指向本地化的 Null 終止寬字串，預期包含更有意義且可採取動作的檔案相關信息。 同步提供者預期會平衡提供更可採取動作的資訊，並盡可能減少記憶體使用量的需求。

DescriptionLength

描述字串的大小，以位元組為單位，其中包含 Null 終止符。

DeviceIdOffset

相對於 CF_SYNC_STATUS開頭的裝置標識碼 Blob 位移。 裝置標識碼 Blob 對平臺是選擇性且不透明的。 Blob 預期在每個裝置上都是唯一的。 如果提供，Blob 將會收集為平臺遙測的一部分，以協助診斷技術問題。

DeviceIdLength

裝置標識元 Blob 的大小，以位元組為單位。

備註

如果 null 指標是在CF_OPERATION_INFO結構的 SyncStatus 字段中設定，平臺將會清除先前設定的同步狀態，如果有。

規格需求

另請參閱

CF_OPERATION_INFO