UnlockFileEx 함수(fileapi.h)
지정된 파일에서 영역 잠금을 해제합니다. 이 함수는 동기적으로 또는 비동기적으로 작동할 수 있습니다.
구문
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 |