CF_UPDATE_FLAGS列舉 (cfapi.h)

更新佔位元檔案或目錄的旗標。

Syntax

typedef enum CF_UPDATE_FLAGS {
  CF_UPDATE_FLAG_NONE,
  CF_UPDATE_FLAG_VERIFY_IN_SYNC,
  CF_UPDATE_FLAG_MARK_IN_SYNC,
  CF_UPDATE_FLAG_DEHYDRATE,
  CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY,
  CF_UPDATE_FLAG_CLEAR_IN_SYNC,
  CF_UPDATE_FLAG_REMOVE_PROPERTY,
  CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA,
  CF_UPDATE_FLAG_ALWAYS_FULL,
  CF_UPDATE_FLAG_ALLOW_PARTIAL
} ;

常數

CF_UPDATE_FLAG_NONE 0x00000000 沒有更新旗標。
CF_UPDATE_FLAG_VERIFY_IN_SYNC 0x00000001 如果目前未在佔位元元上設定 CF_UPDATE_FLAG_MARK_IN_SYNC 屬性，更新將會失敗。 這是為了避免將變更從雲端同步處理到本機佔位元元，以及佔位元的數據流在本機修改之間發生競爭。
CF_UPDATE_FLAG_MARK_IN_SYNC 0x00000002 平臺會在成功的更新佔位元元作業時，將佔位元符標示為同步處理。
CF_UPDATE_FLAG_DEHYDRATE 0x00000004 僅適用於檔案。 指定時，平臺會在成功更新佔位符之後解除凍結檔案。 呼叫端必須在指定這個旗標或數據損毀時取得獨佔句柄。 請注意，平臺不會驗證句柄的獨佔性。
CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION 0x00000008 僅適用於目錄。 指定時，它會標示部分填入更新的佔位元目錄，讓未來存取它會導致傳送給同步提供者的FETCH_PLACEHOLDERS回呼。
CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION 0x00000010 僅適用於目錄。 指定時，它會標示已完整填入的已更新佔位元目錄，讓平臺未來會處理對它的任何存取權，而不需要對同步提供者進行任何回呼。
CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY 0x00000020 指定時，會忽略 CfUpdatePlaceholder 中的 FileIdentity 和 FileIdentityLength，而且平臺會在成功更新呼叫時移除佔位符上的現有檔案識別 Blob。
CF_UPDATE_FLAG_CLEAR_IN_SYNC 0x00000040 平臺會在成功更新佔位元元作業時，將佔位元符標示為未同步。
CF_UPDATE_FLAG_REMOVE_PROPERTY 0x00000080 平臺會移除佔位元元上所有現有的extrinsic屬性。 注意 此值可在 Windows 10 1803 版和更新版本中使用。
CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA 0x00000100 平臺會將 CF_FS_METADATA 傳遞至文件系統，而不需進行任何篩選;否則，平臺會略過設定其值為 0 的任何欄位。 注意 此值可在 Windows 10 1803 版和更新版本中使用。
CF_UPDATE_FLAG_ALWAYS_FULL 0x00000200 CF_UPDATE_FLAG_ALWAYS_FULL 僅適用於佔位符檔案。 指定時，要更新的佔位元一律會標示為完整。 一旦凍結，任何嘗試解除凍結這類佔位符檔案將會失敗，並出現錯誤碼 ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED。
CF_UPDATE_FLAG_ALLOW_PARTIAL 0x00000400 CF_UPDATE_FLAG_ALLOW_PARTIAL 僅適用於佔位符檔案。 指定時，佔位符檔案上的永遠完整狀態會清除，因此允許再次解除凍結。 指定這個旗標以及 CF_UPDATE_FLAG_ALWAYS_FULL 和錯誤碼 ERROR_CLOUD_FILE_INVALID_REQUEST 將傳回為無效的結果。

規格需求

需求	值
最低支援的用戶端	Windows 10 1709 版 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2016 [僅限傳統型應用程式]
標頭	cfapi.h

另請參閱

CfUpdatePlaceholder