Folder::Delete
폴더로부터 지정한 엔트리를 제거합니다.
virtual GSErrCode Delete (
const Name& name,
DataSafety safety = Normal
);
파라미터
- name
- (이 폴더의) 제거할 엔트리의 이름입니다.
- safety
- 동작의 범위를 제어하는 데이터 보안 레벨입니다.
리턴 값
| 값 | 의미 |
|---|---|
| NoError* | OK |
| TargetNotFound* | 이 엔트리를 찾을 수 없습니다. |
| AccessDenied* | 이 동작을 이 폴더 혹은 엔트리에서 허용하지 않습니다. |
| Error* | 불특정 오류입니다. |
* Folder class 범위에서 선언함
* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함
설명
이 메소드는 폴더로부터 name으로 지정한 이름을 가진 파일 시스템 엔트리(파일, 폴더, 링크)를 제거합니다. Delete 동작은 (내부 내용들과 함께) 전체 엔트리에 적용됩니다. 이것은 제거 동작이 본질적으로 재귀적이라는 것을 의미합니다.
만약 폴더에 기록할 수 없다면 Delete는 실패합니다.
IgnoreWriteProtection 값을 safety 파라미터에 전달하지 않는다면, 쓰기-보호된 엔트리 (Windows의 경우 읽기-전용 엔트리, Macintosh의 경우 잠긴 엔트리) 상에서 Delete는 실패합니다.
Windows 참고:
- 이 메소드는 루트 폴더에서 실패합니다. (왜냐하면 가상이며 기록할 수 없기 때문입니다)
Macintosh 참고:
- 이 메소드는 루트 폴더에서 실패합니다. (왜냐하면 가상이며 기록할 수 없기 때문입니다)
