CfReferenceProtectedHandle function (cfapi.h)
Allows the caller to reference a protected handle to a Win32 handle which can be used with non-CfApi Win32 APIs.
Syntax
BOOLEAN CfReferenceProtectedHandle(
[in] HANDLE ProtectedHandle
);
Parameters
[in] ProtectedHandle
The protected handle of a placeholder file.
Return value
If this function succeeds, it returns TRUE
. Otherwise, it returns FALSE
.
Remarks
Every CfReferenceProtectedHandle call must be matched with a CfReleaseProtectedHandle call. It is not recommended to reference a protected handle for a long period of time, as doing so will prevent the oplock break notification from being acknowledged.
The caller should instead break up long running tasks into smaller sub-tasks and reference/release the protected handle for each sub-task.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 10, version 1709 [desktop apps only] |
Minimum supported server | Windows Server 2016 [desktop apps only] |
Target Platform | Windows |
Header | cfapi.h |
Library | CldApi.lib |
DLL | CldApi.dll |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for