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

추가 정보

CfReleaseProtectedHandle