cfReferenceProtectedHandle 函数 (cfapi.h)

  • 项目

允许调用方将受保护的句柄引用到可用于非 CfApi Win32 API 的 Win32 句柄。

语法

BOOLEAN CfReferenceProtectedHandle(
  [in] HANDLE ProtectedHandle
);

参数

[in] ProtectedHandle

占位符文件的受保护句柄。

返回值

如果此函数成功，则返回 TRUE。 否则，将返回 FALSE。

注解

每个 CfReferenceProtectedHandle 调用都必须与 CfReleaseProtectedHandle 调用匹配。 不建议长时间引用受保护的句柄，因为这样做会阻止确认 oplock 中断通知。

相反，调用方应将长时间运行的任务分解为较小的子任务，并引用/释放每个子任务的受保护句柄。

要求

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

另请参阅

CfReleaseProtectedHandle