MoveFileExA 함수(winbase.h)

다양한 이동 옵션을 사용하여 자식을 포함하여 기존 파일 또는 디렉터리를 이동합니다.

MoveFileWithProgress 함수는 moveFileWithProgress 진행률 알림을 받는 콜백 함수를 제공할 수 있다는 점을 제외하고 MoveFileEx 함수와 동일합니다.

이 작업을 트랜잭션 작업으로 수행하려면 MoveFileTransacted 함수를 사용합니다.

통사론

BOOL MoveFileExA(
  [in]           LPCSTR lpExistingFileName,
  [in, optional] LPCSTR lpNewFileName,
  [in]           DWORD  dwFlags
);

매개 변수

[in] lpExistingFileName

로컬 컴퓨터의 파일 또는 디렉터리의 현재 이름입니다.

dwFlagsMOVEFILE_DELAY_UNTIL_REBOOT지정하는 경우 지연된 작업은 네트워크를 사용할 수 있기 전에 수행되므로 원격 공유에 파일이 있을 수 없습니다.

기본적으로 이름은 MAX_PATH 문자로 제한됩니다. 이 제한을 32,767자로 확장하려면 경로 앞에 "\\?\"를 추가합니다. 자세한 내용은 이름 지정 파일, 경로 및 네임스페이스참조하세요.

[in, optional] lpNewFileName

로컬 컴퓨터의 파일 또는 디렉터리의 새 이름입니다.

파일을 이동할 때 대상은 다른 파일 시스템 또는 볼륨에 있을 수 있습니다. 대상이 다른 드라이브에 있는 경우 dwFlagsMOVEFILE_COPY_ALLOWED 플래그를 설정해야 합니다.

디렉터리를 이동할 때 대상은 동일한 드라이브에 있어야 합니다.

dwFlags MOVEFILE_DELAY_UNTIL_REBOOT 지정하고 lpNewFileName NULL경우 MoveFileEx 시스템을 다시 시작할 때 삭제할 lpExistingFileName 파일을 등록합니다. lpExistingFileName 디렉터리를 참조하는 경우 시스템은 디렉터리가 비어 있는 경우에만 다시 시작할 때 디렉터리를 제거합니다.

기본적으로 이름은 MAX_PATH 문자로 제한됩니다. 이 제한을 32,767자로 확장하려면 경로 앞에 "\\?\"를 추가합니다. 자세한 내용은 이름 지정 파일, 경로 및 네임스페이스참조하세요.

[in] dwFlags

이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

반환 값

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

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

발언

dwFlags 매개 변수가 MOVEFILE_DELAY_UNTIL_REBOOT지정하면 레지스트리에 액세스할 수 없으면 MoveFileEx 실패합니다. 이 함수는 다시 시작할 때 이름을 바꿀 파일의 위치를 다음 레지스트리 값에 저장합니다. HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\PendingFileRenameOperations

이 레지스트리 값은 REG_MULTI_SZ형식입니다. 각 이름 바꾸기 작업은 이름 바꾸기가 삭제인지 여부에 따라 다음 NULL로 끝나는 문자열 중 하나를 저장합니다.

• szSrcFile\0\0
• szSrcFile\0szDstFile\0

MoveFileEx(szSrcFile, NULL, MOVEFILE_DELAY_UNTIL_REBOOT);
MoveFileEx(szSrcFile, szDstFile, MOVEFILE_DELAY_UNTIL_REBOOT);