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 结合使用时， Overlapped 允许平台异步执行 CfRevertPlaceholder 调用。 有关更多详细信息，请参阅 “备注 ”。

如果未指定，平台将同步执行 API 调用，而不考虑句柄的创建方式。

返回值

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

调用方必须对要还原的占位符具有 WRITE_DATA 或 WRITE_DAC 访问权限。

如果在调用时占位符尚未完全冻结，则筛选器将向同步提供程序发送 FETCH_DATA 回调以冻结文件。 如果无法冻结文件，还原将失败，状态STATUS_CLOUD_FILE_ACCESS_DENIED。

如果 API 在异步使用 Overlapped 时返回HRESULT_FROM_WIN32 (ERROR_IO_PENDING) ，则调用方可以使用 GetOverlappedResult 等待。

要求

要求 值
最低受支持的客户端 Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 cfapi.h
Library CldApi.lib
DLL CldApi.dll

另请参阅

GetOverlappedResult

CF_REVERT_FLAGS