CfRevertPlaceholder 函式 (cfapi.h)
將佔位元還原回一般檔案，並移除所有特殊特性，例如重新剖析標籤、檔案身分識別等。
語法
HRESULT CfRevertPlaceholder(
[in] HANDLE FileHandle,
[in] CF_REVERT_FLAGS RevertFlags,
[in, out, optional] LPOVERLAPPED Overlapped
);
參數
[in] FileHandle
即將還原為一般檔案或目錄的檔案或目錄佔位元句柄。 平臺會正確同步處理還原作業與其他作用中要求。 屬性或無存取句柄已足夠。
[in] RevertFlags
佔位元還原旗標。 RevertFlags 應該設定為 CF_REVERT_FLAG_NONE。
[in, out, optional] Overlapped
當指定並結合異步 FileHandle 時， 重疊 可讓平臺以異步方式執行 CfRevertPlaceholder 呼叫。 如需詳細資訊，請參閱。
如果未指定，不論句柄的建立方式為何，平臺都會同步執行 API 呼叫。
傳回值
如果函式成功，則會傳 S_OK回 。 否則，它會傳回 HRESULT 錯誤碼。
備註
呼叫端必須具有要還原之佔位符 的WRITE_DATA 或 WRITE_DAC 存取權。
如果占位元元在呼叫時尚未完全凍結，則篩選條件會將 FETCH_DATA 回呼傳送給同步提供者，以凍結檔案。 如果檔案無法凍結，還原將會失敗，狀態 STATUS_CLOUD_FILE_ACCESS_DENIED。
如果 API 以異步方式使用 重 疊時傳回HRESULT_FROM_WIN32 (ERROR_IO_PENDING) ，則呼叫端可以使用 GetOverlappedResult 等候。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1709 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | cfapi.h |
| 程式庫 | CldApi.lib |
| Dll | CldApi.dll |