MoveFileWithProgressA 함수(winbase.h)
자식을 포함하여 파일 또는 디렉터리를 이동합니다. 진행률 알림을 받는 콜백 함수를 제공할 수 있습니다.
이 작업을 트랜잭션 작업으로 수행하려면 MoveFileTransacted 함수를 사용합니다.
통사론
BOOL MoveFileWithProgressA(
[in] LPCSTR lpExistingFileName,
[in, optional] LPCSTR lpNewFileName,
[in, optional] LPPROGRESS_ROUTINE lpProgressRoutine,
[in, optional] LPVOID lpData,
[in] DWORD dwFlags
);
매개 변수
[in] lpExistingFileName
로컬 컴퓨터에 있는 기존 파일 또는 디렉터리의 이름입니다.
dwFlagsMOVEFILE_DELAY_UNTIL_REBOOT지정하는 경우 지연된 작업이 네트워크를 사용할 수 있기 전에 수행되므로 원격 공유에 파일이 있을 수 없습니다.
기본적으로 이름은 MAX_PATH 문자로 제한됩니다. 이 제한을 32,767자로 확장하려면 경로 앞에 "\\?\"를 추가합니다. 자세한 내용은 이름 지정 파일, 경로 및 네임스페이스참조하세요.
팁
Windows 10 버전 1607부터 "\\?\" 앞에 추가하지 않고 MAX_PATH 제한을 제거하도록 옵트인할 수 있습니다. 자세한 내용은 명명 파일, 경로 및 네임스페이스의 "최대 경로 길이 제한" 섹션을.
[in, optional] lpNewFileName
로컬 컴퓨터의 파일 또는 디렉터리의 새 이름입니다.
파일을 이동할 때 lpNewFileName 다른 파일 시스템 또는 볼륨에 있을 수 있습니다. lpNewFileName 다른 드라이브에 있는 경우 dwFlagsMOVEFILE_COPY_ALLOWED 플래그를 설정해야 합니다.
디렉터리를 이동할 때 lpExistingFileName 및 lpNewFileName 동일한 드라이브에 있어야 합니다.
기본적으로 이름은 MAX_PATH 문자로 제한됩니다. 이 제한을 32,767자로 확장하려면 경로 앞에 "\\?\"를 추가합니다. 자세한 내용은 이름 지정 파일, 경로 및 네임스페이스참조하세요.
팁
Windows 10 버전 1607부터 "\\?\" 앞에 추가하지 않고 MAX_PATH 제한을 제거하도록 옵트인할 수 있습니다. 자세한 내용은 명명 파일, 경로 및 네임스페이스의 "최대 경로 길이 제한" 섹션을.
[in, optional] lpProgressRoutine
파일의 다른 부분이 이동될 때마다 호출되는 CopyProgressRoutine 콜백 함수에 대한 포인터입니다. 콜백 함수는 작업의 진행률을 표시하는 사용자 인터페이스를 제공하는 경우에 유용할 수 있습니다. 이 매개 변수는 NULL
[in, optional] lpData
CopyProgressRoutine 콜백 함수에 전달할 인수입니다. 이 매개 변수는 NULL
[in] dwFlags
이동 옵션입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.
반환 값
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.
볼륨 간에 파일을 이동할 때 사용자가 작업을 취소하여 lpProgressRoutinePROGRESS_CANCEL 반환하는 경우 moveFileWithProgress 0을 반환하고 GetLastErrorERROR_REQUEST_ABORTED반환합니다. 기존 파일은 그대로 유지됩니다.
볼륨 간에 파일을 이동할 때 lpProgressRoutine 사용자가 작업을 중지하여 PROGRESS_STOP 반환하는 경우 moveFileWithProgress 0을 반환하고 GetLastErrorERROR_REQUEST_ABORTED반환합니다. 기존 파일은 그대로 유지됩니다.
발언
MoveFileWithProgress 함수는 링크 추적 서비스와 작업을 조정하므로 링크 원본이 이동될 때 추적할 수 있습니다.
파일을 삭제하거나 이름을 바꾸려면 파일에 대한 삭제 권한이 있거나 부모 디렉터리에서 자식 권한을 삭제해야 합니다. 자식 삭제 및 삭제를 제외한 모든 액세스 권한이 있는 디렉터리를 설정하고 새 파일의 ACL을 상속하는 경우 파일을 삭제하지 않고도 파일을 만들 수 있어야 합니다. 그러나 파일을 만들면 파일을 만들 때 반환된 핸들에 대해 요청하는 모든 액세스 권한을 얻을 수 있습니다. 파일을 만들 때 삭제 권한을 요청한 경우 해당 핸들을 사용하지만 다른 핸들은 사용하지 않고 파일 이름을 삭제하거나 이름을 바꿀 수 있습니다.
Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술에서 지원됩니다.
| 기술 | 지원 |
|---|---|
| SMB(서버 메시지 블록) 3.0 프로토콜 | 예 |
| SMB 3.0 TFO(투명한 장애 조치(failover) | 예 |
| SO(스케일 아웃 파일 공유)가 있는 SMB 3.0 | 예 |
| CsvFS(클러스터 공유 볼륨 파일 시스템) | 예 |
| ReFS(복원 파일 시스템) | 예 |
CsvFs는 압축된 파일에 대해 리디렉션된 IO를 수행합니다.
메모
winbase.h 헤더는 MOVEFileWithProgress를 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winbase.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |
참고 항목
copyFileEx
copyProgressRoutine
moveFileEx
moveFileTransacted