Folder::Rename

폴더의 지정한 엔트리의 이름을 변경합니다.

virtual GSErrCode  Rename (
    const Name& from,
    const Name& to
);

파라미터

from

이름을 변경할 (폴더 내) 엔트리의 원래 이름입니다.

to

(폴더 내) 엔트리의 새로운 이름입니다.

리턴 값

값	의미
NoError*	OK
SourceNotFound*	원래 (소스) 엔트리를 발견하지 못했습니다.
TargetExists*	새로운 (대상) 이름을 가진 엔트리가 폴더에 이미 존재합니다.
AccessDenied*	이 동작을 이 폴더 또는 이 엔트리에서 허용하지 않습니다.
Error*	불특정 오류입니다.

^* Folder class 범위에서 선언함
^* GS 네임스페이스에서 선언했지만, 글로벌 범위에서 접근 가능함

설명

이 메소드는 원래 이름 from을 가진 폴더 내 파일 시스템 엔트리(파일, 폴더, 링크)의 이름을 새로운 이름 to로 변경합니다.

만약 폴더가 이미 이름 folderName을 가진 엔트리(파일, 폴더, 링크)를 포함하고 있으며, 기록할 수 없는 폴더 상이라면 CreateFolder는 실패합니다. 만약 폴더가 이미 이름 to를 가진 엔트리(파일, 폴더, 링크)를 포함하고 있으며, 기록할 수 없는 폴더 상이라면 Rename은 실패합니다.

 Windows 참고:

• 이 메소드는 루트 폴더에서 실패합니다. (가상이며 기록할 수 없기 때문입니다)

 Macintosh 참고:

• 이 메소드는 특히 루트 폴더에 대하여 작동합니다. (비록 가상이며 기록할 수 없다고 취급하지만) 그래서 볼륨의 이름을 변경하는 것이 가능합니다.

다음 버전부터 이용 가능합니다: 1.0