FileSystem::Move
파일 시스템에서 지정한 엔트리를 이동합니다.
GSErrCode Move (
const Location& from,
const Location& to,
DataSafety safety = Normal
);
파라미터
- from
- 이동할 엔트리의 위치입니다.
- to
- 엔트리의 새로운 (목적지 또는 대상) 위치입니다.
- safety
- 동작의 범위를 제어하는 데이터 보안 레벨입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| SourceNotFound* | 이동할 소스 엔트리를 발견하지 못했습니다. |
| TargetExists* | 파일 시스템에서 대상 위치를 가진 엔트리가 이미 존재합니다. |
| DeviceIsFull* | 디바이스가 가득 찼습니다. |
| AccessDenied* | 부모 폴더 또는 엔트리 상에서 동작을 허용하지 않습니다. |
| Error* | 불특정 오류입니다. |
* FileSystem class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 메소드는 위치로 식별되는 파일 시스템 엔트리(파일, 폴더, 링크)를 새로운 위치로 이동(재배치)시킵니다. 소스 부모 폴더와 목적지 부모 폴더는 같을 수 있습니다. (이름 변경 동작을 야기함) 이동 동작은 (내부 내용과 함께) 전체 엔트리에게 적용됩니다. 이는 이동 동작이 본질적으로 재귀적이라는 것을 의미합니다.
만약 파일 시스템이 대상 위치를 가진 엔트리(파일, 폴더, 링크)를 이미 포함하고 있으며 부모 폴더들 중 하나라도 기록할 수 없다면, Move는 실패합니다. 만약 이동 동작 도중에 실패하면, 원래 파일 시스템 상태를 복구하려고 시도할 것입니다.
safety 파라미터에 IgnoreWriteProtection 값을 전달하지 않는 한, 쓰기 보호 엔트리들 (Windows의 경우 read-only 엔트리, Macintosh의 경우 lock 엔트리) 상에서 Move는 실패합니다.
Windows 참고:
- 이 메소드는 루트 폴더에서 실패합니다. (가상이며 기록할 수 없기 때문입니다)
- 만약 소스 볼륨과 목적지 볼륨이 다르다면, 복사 및 제거 동작으로 이동을 수행합니다.
Macintosh 참고:
- 부모 폴더 둘 다 루트 폴더일 때를 제외하면, 이 메소드는 루트 폴더에서 실패합니다. (가상이며 기록할 수 없기 때문입니다) 그래서 볼륨들의 이름을 변경하는 것이 가능합니다.
- 만약 소스 볼륨과 목적지 볼륨이 다르거나 목적지 부모 폴더에 소스의 이름을 가진 엔트리가 존재한다면, 복사 및 제거 동작으로 이동을 수행합니다.
- 리소스 포크(fork)와 데이터 포크(fork) 모두 이동됩니다.
