CF_CONVERT_FLAGS列舉 (cfapi.h)
一般檔案/目錄到預留位置檔案/目錄轉換旗標。
Syntax
typedef enum CF_CONVERT_FLAGS {
CF_CONVERT_FLAG_NONE = 0x00000000,
CF_CONVERT_FLAG_MARK_IN_SYNC = 0x00000001,
CF_CONVERT_FLAG_DEHYDRATE = 0x00000002,
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION = 0x00000004,
CF_CONVERT_FLAG_ALWAYS_FULL = 0x00000008,
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE = 0x00000010
} ;
常數
CF_CONVERT_FLAG_NONE值： 0x00000000 沒有轉換旗標。 |
|
CF_CONVERT_FLAG_MARK_IN_SYNC值： 0x00000001 平臺會在成功轉換檔案時，將轉換的預留位置標示為與雲端同步。 |
|
CF_CONVERT_FLAG_DEHYDRATE值： 0x00000002 僅適用于檔案。 當指定時，平臺會在成功將檔案轉換成預留位置之後將檔案解除凍結。 呼叫端必須在指定此旗標或資料損毀時取得獨佔控制碼。 請注意，平臺不會驗證控制碼的獨佔性。 |
|
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION值： 0x00000004 僅適用于目錄。 當指定時，它會將轉換的預留位置目錄標示為部分填入，讓任何未來的存取權都會導致傳送給同步提供者 FETCH_PLACEHOLDERS 回呼。 |
|
CF_CONVERT_FLAG_ALWAYS_FULL值： 0x00000008 當此旗標存在時，新建立的預留位置將會標示為永遠已滿。 一旦凍結，任何嘗試將這類 (檔案解除凍結) 預留位置將會失敗，並出現錯誤碼 ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED。 此旗標只會在預留位置檔案上強制執行。 它可以在預留位置目錄上設定，但沒有任何作用。 |
|
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE值： 0x00000010 指定時，平臺可讓同步處理引擎以不可部分完成的方式轉換非雲端檔案預留位置， (另一個重新剖析標籤/資料) 至雲端檔案預留位置。 請注意，API 通常會無法將任何非預留位置檔案轉換成預留位置。 組合 ** (CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE |
當某些提供者從另一個平臺移轉至雲端檔案平臺，而且想要將較舊平臺上的已凍結預留位置轉換為雲端檔案平臺上不可部分凍結的預留位置時，CF_CONVERT_FLAG_DEHYDRATE) ** 特別有用。 只應該傳遞此旗標，以將完整預留位置轉換為雲端檔案預留位置。 如果較舊的平臺將完整檔案實作為一般、非預留位置檔案，則不需要此旗標。 在目錄上傳遞此旗標也會將目錄轉換成雲端檔案，但 DEHYDRATE 旗標不適用於目錄。 即使已使用CfRegisterSyncRoot指定原則CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_TO_UNRESTRICTED，也只允許已註冊/連線至雲端檔案同步根目錄的進程指定此旗標。 >[!注意] >只有在從CfGetPlatformInfo取得的 為 0x500 或更新版本時 PlatformVersion.IntegrationNumber ，才支援 旗標。 |
規格需求
| 最低支援的用戶端 | Windows 10 1709 版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 標頭 | cfapi.h |