UnlockFile 함수(fileapi.h)

아티클
08/23/2023

열려 있는 파일에서 지역 잠금을 해제합니다. 지역을 잠금 해제하면 다른 프로세스가 지역에 액세스할 수 있습니다.

지역을 지정하는 다른 방법은 UnlockFileEx 함수를 사용합니다.

구문

BOOL UnlockFile(
  [in] HANDLE hFile,
  [in] DWORD  dwFileOffsetLow,
  [in] DWORD  dwFileOffsetHigh,
  [in] DWORD  nNumberOfBytesToUnlockLow,
  [in] DWORD  nNumberOfBytesToUnlockHigh
);

매개 변수

[in] hFile

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

[in] dwFileOffsetLow

잠긴 영역이 시작되는 파일의 시작 바이트 오프셋의 하위 순서 단어입니다.

[in] dwFileOffsetHigh

잠긴 영역이 시작되는 파일의 시작 바이트 오프셋의 상위 단어입니다.

[in] nNumberOfBytesToUnlockLow

잠금 해제할 바이트 범위 길이의 낮은 순서 단어입니다.

[in] nNumberOfBytesToUnlockHigh

잠금 해제할 바이트 범위 길이의 상위 단어입니다.

반환 값

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

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

설명

이 함수는 항상 동기적으로 작동하지만 완료 포트가 파일 핸들과 연결된 경우 완료 항목을 큐에 대기하지 않을 수 있습니다.

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

프로세스가 잠긴 파일의 일부로 종료되거나 미해결 잠금이 있는 파일을 닫으면 운영 체제에서 잠금이 잠금 해제됩니다. 그러나 운영 체제에서 이러한 잠금을 해제하는 데 걸리는 시간은 사용 가능한 시스템 리소스에 따라 달라집니다. 따라서 프로세스가 종료되면 잠긴 모든 파일의 잠금을 명시적으로 해제하는 것이 좋습니다. 이 작업을 수행하지 않으면 운영 체제에서 아직 잠금을 해제하지 않은 경우 이러한 파일에 대한 액세스가 거부될 수 있습니다.

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