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 字段中設定,平臺將會清除先前設定的同步狀態,如果有。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1803 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
標頭 | cfapi.h |