將受保護的句柄轉換為 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 |
| 程式庫 | CldApi.lib |
| Dll | CldApi.dll |