SHFileOperation(A)

SHFileOperation(A)

파일 시스템 오브젝트의 카피·이동·이름의 변경·삭제를 행합니다.

int SHFileOperationA(
    LPSHFILEOPSTRUCT pFileOp   // SHFILEOPSTRUCT구조체
);

SHELL32.DLL

인수

pFileOp

실행하는 조작에 관한 정보를 격납했다 SHFILEOPSTRUCT 구조체의 주소를 지정합니다.

반환값

성공하면 0 하지만 돌아갑니다.

실패하면 0 이외의 값이 돌아갑니다.

해설

이 함수에서는, 패스명을 지정할 경우에 풀 패스를 사용해야 합니다.상대 패스명의 사용은 스렛드세이후(복수의 스렛드에 의한 액세스로 문제가 생기지 않는 방법)가 아닙니다.

이 함수는, 로컬 드라이브로부터, 네트워크 패스로 지정되는 리모트 컴퓨터에, 특수 폴더를 이동시킬 수 없습니다.다만, CSIDL_PERSONAL ( MyDocs 폴더)와 CSIDL_MYPICTURES ( MyPics 폴더)의 경우는 가능합니다.

이 함수를 파일을 삭제하는데 사용하는 경우, 함수는 파일을 쓰레기통으로 옮기려고 합니다.파일을 쓰레기통에 두지 않고 완전하게 삭제하려면 , DeleteFile 함수를 사용합니다.

카피 콜백 핸들러가 등록되어 있는 경우에는, 이 함수의 호출로 FOF_NOCONFIRMATION 플래그를 지정하지 않는 한, 등록되어 있는 핸들러(ICopyHook 인터페이스의 CopyCallback 메소드)가 불려 갑니다.

대응 정보

Shell32.dll Version 4.00 이후

Windows 95 이후 / Windows NT 4.0 이후