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 |
라이브러리 | CldApi.lib |
DLL | CldApi.dll |