CfGetWin32HandleFromProtectedHandle 函数 (cfapi.h)

将受保护的句柄转换为 Win32 句柄,以便它可以与所有基于句柄的 Win32 API 一起使用。

语法

HANDLE CfGetWin32HandleFromProtectedHandle(
  [in] HANDLE ProtectedHandle
);

参数

[in] ProtectedHandle

要转换的受保护句柄。

返回值

相应的 Win32 句柄。

注解

调用方必须在调用之前使用 CfReferenceProtectedHandle 引用受保护的句柄,以确保跟踪 Win32 句柄的使用,并且使用 Win32 句柄的 Win32 API 调用与 oplock 中断通知确认同步。

调用方在使用 CfReleaseProtectedHandle 处理 Win32 句柄后,必须释放受保护句柄上的引用。

在任何情况下,调用方都不应关闭使用 CfCloseHandle 返回的 Win32 句柄。

要求

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

另请参阅

CfReferenceProtectedHandle

CfReleaseProtectedHandle

CfCloseHandle