cfReferenceProtectedHandle 函数 (cfapi.h)

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

语法

BOOLEAN CfReferenceProtectedHandle(
  [in] HANDLE ProtectedHandle
);

[in] ProtectedHandle

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

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

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

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