다음을 통해 공유

IFileOperation::SetOperationFlags 메서드(shobjidl_core.h)

  • 아티클

현재 작업에 대한 매개 변수를 설정합니다.

구문

HRESULT SetOperationFlags(
  [in] DWORD dwOperationFlags
);

매개 변수

[in] dwOperationFlags

형식:DWORD

파일 작업을 제어하는 플래그입니다. 이 멤버는 다음 플래그의 조합일 수 있습니다. FOF 플래그는 Shellapi.h에 정의되고 FOFX 플래그는 Shobjidl.h에 정의됩니다.

참고 이 메서드가 호출되지 않으면 작업에서 사용하는 기본값은 | FOF_ALLOWUNDO. FOF_NOCONFIRMMKDIR.
 

FOF_ALLOWUNDO(0x0040)

가능한 경우 실행 취소 정보를 유지합니다.

Windows Vista 이전에는 원래 작업을 수행한 동일한 프로세스에서만 작업을 실행 취소할 수 있었습니다.

Windows Vista 이상 시스템에서 실행 취소의 scope 사용자 세션입니다. 사용자 세션에서 실행되는 모든 프로세스는 다른 작업을 실행 취소할 수 있습니다. 실행 취소 상태는 Explorer.exe 프로세스에서 유지되며 해당 프로세스가 실행되는 한 실행 취소 함수를 조정할 수 있습니다.

원본 파일 매개 변수에 정규화된 경로 및 파일 이름이 포함되어 있지 않으면 이 플래그는 무시됩니다.

FOF_FILESONLY(0x0080)

와일드카드 파일 이름(.)이 지정된 경우 폴더가 아닌 파일에서만 작업을 수행합니다.

FOF_NOCONFIRMATION(0x0010)

표시되는 모든 대화 상자에 대해 모두 예 로 응답합니다.

FOF_NOCONFIRMMKDIR(0x0200)

작업에서 폴더를 만들어야 하는 경우 새 폴더 만들기를 확인하지 마세요.

FOF_NO_CONNECTED_ELEMENTS(0x2000)

연결된 항목을 그룹으로 이동하지 마세요. 지정된 파일만 이동합니다.

FOF_NOCOPYSECURITYATTRIBS(0x0800)

항목의 보안 특성을 복사하지 마세요.

FOF_NOERRORUI(0x0400)

오류가 발생하는 경우 사용자에게 메시지를 표시하지 마세요. 이 플래그가 FOFX_EARLYFAILURE 없이 설정된 경우 사용자가 대화 상자에서 무시 또는 계속 을 선택한 것처럼 오류가 처리됩니다. 현재 작업을 중지하고, 작업이 중단되었음을 나타내는 플래그를 설정하고, 나머지 작업을 진행합니다.

FOF_NORECURSION(0x1000)

로컬 폴더에서만 작동합니다. 하위 디렉터리로 재귀적으로 작동하지 않습니다.

FOF_RENAMEONCOLLISION(0x0008)

대상 이름을 가진 항목이 이미 있는 경우 이동, 복사 또는 이름 바꾸기 작업에서 새 이름으로 작업 중인 항목을 지정합니다.

FOF_SILENT(0x0004)

진행률 대화 상자를 표시하지 마세요.

FOF_WANTNUKEWARNING(0x4000)

파일 또는 폴더가 재활용되지 않고 삭제 작업 중에 제거되는 경우 경고를 보냅니다. 이 플래그는 FOF_NOCONFIRMATION 부분적으로 재정의합니다.

FOFX_ADDUNDORECORD(0x20000000)

Windows 8 도입되었습니다. 파일 작업이 사용자 호출되었으며 실행 취소 스택에 배치되어야 합니다. 이 플래그는 FOF_ALLOWUNDO 것이 좋습니다.

FOFX_NOSKIPJUNCTIONS(0x00010000)

셸 네임스페이스 접합으로 이동합니다. 기본적으로 접합은 입력되지 않습니다. 접합에 대한 자세한 내용은 네임스페이스 확장의 위치 지정을 참조하세요.

가능하면 대상에 있는 파일의 새 instance 아닌 하드 링크를 만듭니다.

FOFX_SHOWELEVATIONPROMPT(0x00040000)

작업에 상승된 권한이 필요하고 FOF_NOERRORUI 플래그가 오류 UI를 사용하지 않도록 설정된 경우 그럼에도 불구하고 UAC UI 프롬프트를 표시합니다.

FOFX_EARLYFAILURE(0x00100000)

FOFX_EARLYFAILURE FOF_NOERRORUI 함께 설정된 경우 모든 작업에서 오류가 발생하면 전체 작업 집합이 중지됩니다. 이 플래그는 FOF_NOERRORUI 설정된 경우에만 유효합니다.

FOFX_PRESERVEFILEEXTENSIONS(0x00200000)

파일 이름 확장명을 유지하는 방식으로 충돌 이름을 바꿉니다. 이 플래그는 FOF_RENAMEONCOLLISION 설정된 경우에만 유효합니다.

FOFX_KEEPNEWERFILE(0x00400000)

충돌이 발생하는 경우 Date Modified 속성을 기반으로 최신 파일 또는 폴더를 유지합니다. 사용자에게 표시되는 프롬프트 UI 없이 자동으로 수행됩니다.

FOFX_NOCOPYHOOKS(0x00800000)

복사 후크를 사용하지 마세요.

FOFX_NOMINIMIZEBOX(0x01000000)

진행률 대화 상자를 최소화할 수 없습니다.

FOFX_MOVEACLSACROSSVOLUMES(0x02000000)

볼륨 간 이동 작업을 수행할 때 원본 항목의 보안 특성을 대상 항목에 복사합니다. 이 플래그가 없으면 대상 항목은 새 폴더의 보안 특성을 받습니다.

FOFX_DONTDISPLAYSOURCEPATH(0x04000000)

진행률 대화 상자에 원본 항목의 경로를 표시하지 마세요.

FOFX_DONTDISPLAYDESTPATH(0x08000000)

진행률 대화 상자에 대상 항목의 경로를 표시하지 마세요.

FOFX_RECYCLEONDELETE(0x00080000)

Windows 8 도입되었습니다. 파일이 삭제되면 파일을 영구적으로 삭제하는 대신 휴지통으로 보냅니다.

FOFX_REQUIREELEVATION(0x10000000)

Windows Vista SP1에 도입되었습니다. 사용자는 권한 상승에 대한 요구 사항이 있으므로 권한 상승 확인을 요청하는 대화 상자를 표시하지 마세요.

FOFX_COPYASDOWNLOAD(0x40000000)

Windows 7에 도입되었습니다. 진행률 대화 상자에서 메시지를 복사하는 대신 다운로드를 표시합니다.

FOFX_DONTDISPLAYLOCATIONS(0x80000000)

Windows 7에 도입되었습니다. 진행률 대화 상자에 위치 줄을 표시하지 마세요.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

IFileOperation::P erformOperations를 호출하기 전에 이러한 플래그를 설정하여 복사, 삭제 또는 이름 바꾸기와 같이 수행되는 모든 작업에 대한 매개 변수를 정의합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista, Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 shobjidl_core.h(Shobjidl.h 포함)