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 等候。

規格需求

另請參閱

GetOverlappedResult

CF_REVERT_FLAGS