UnlockFileEx 함수(fileapi.h)

아티클
08/23/2023

지정된 파일에서 영역 잠금을 해제합니다. 이 함수는 동기적으로 또는 비동기적으로 작동할 수 있습니다.

구문

BOOL UnlockFileEx(
  [in]      HANDLE       hFile,
            DWORD        dwReserved,
  [in]      DWORD        nNumberOfBytesToUnlockLow,
  [in]      DWORD        nNumberOfBytesToUnlockHigh,
  [in, out] LPOVERLAPPED lpOverlapped
);

매개 변수

[in] hFile

파일에 대한 핸들입니다. 핸들은 GENERIC_READ 또는GENERIC_WRITE 액세스 권한으로 만들어졌어야 합니다. 자세한 내용은 파일 보안 및 액세스 권한을 참조하세요.

dwReserved

예약된 매개 변수; 는 0이어야 합니다.

[in] nNumberOfBytesToUnlockLow

잠금을 해제할 바이트 범위 길이의 하위 부분입니다.

[in] nNumberOfBytesToUnlockHigh

잠금을 해제할 바이트 범위 길이의 상위 부분입니다.

[in, out] lpOverlapped

함수가 잠금 해제 요청과 함께 사용하는 OVERLAPPED 구조체에 대한 포인터입니다. 이 구조체는 잠금 해제 범위의 시작 부분의 파일 오프셋을 포함합니다. hEvent 멤버를 유효한 핸들 또는 0으로 초기화해야 합니다. 자세한 내용은 동기 및 비동기 I/O를 참조하세요.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0 또는 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

파일의 영역을 잠금 해제하면 이전에 획득한 파일 잠금이 해제됩니다. 잠금 해제할 지역은 기존 잠긴 지역과 정확히 일치해야 합니다. 파일의 인접한 두 영역을 별도로 잠근 다음 잠긴 두 영역에 걸쳐 있는 단일 영역을 사용하여 잠금을 해제할 수 없습니다.

CloseHandle 함수의 처리가 완료되기 전에 잠금이 해제됩니다.

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

기술	지원됨
SMB(서버 메시지 블록) 3.0 프로토콜	Yes
SMB 3.0 TFO(투명 장애 조치(failover))	Yes
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0	Yes
CsvFS(클러스터 공유 볼륨 파일 시스템)	Yes
ReFS(Resilient File System)	Yes

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	fileapi.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll