CopyFileFromAppW 함수(fileapifromapp.h)

새 파일에 기존 파일을 복사합니다. 이 함수는 유니버설 Windows 플랫폼 앱 보안 모델을 준수한다는 점을 제외하고 이 함수의 동작은 CopyFile과 동일합니다.

구문

WINSTORAGEAPI BOOL CopyFileFromAppW(
  LPCWSTR lpExistingFileName,
  LPCWSTR lpNewFileName,
  BOOL    bFailIfExists
) noexcept;

lpExistingFileName

기존 파일의 이름입니다.

"\\?\" 앞에 추가하지 않고 MAX_PATH 제한을 옵트아웃하는 방법에 대한 자세한 내용은 파일, 경로 및 네임스페이스의 "최대 경로 길이 제한" 섹션을 참조하세요.

lpExistingFileName이 없으면 함수가 실패하고 GetLastError가ERROR_FILE_NOT_FOUND 반환합니다.

lpNewFileName

새 파일의 이름입니다.

이 함수의 ANSI 버전에서는 이름이 MAX_PATH 문자로 제한됩니다. 이 제한을 32,767 와이드 문자로 확장하려면 함수의 유니코드 버전을 호출하고 경로에 "\\?\" 앞에 을 추가합니다. 자세한 내용은 파일 이름 지정을 참조하세요.

이 함수의 유니코드 버전(CopyFileFromAppW)의 경우 "\\?\" 앞에 추가하지 않고 도 MAX_PATH 제한을 제거하도록 옵트인할 수 있습니다. 자세한 내용은 파일, 경로 및 네임스페이스의 "최대 경로 길이 제한" 섹션을 참조하세요.

bFailIfExists

이 매개 변수가 TRUE 이고 lpNewFileName 으로 지정된 새 파일이 이미 있는 경우 함수가 실패합니다. 이 매개 변수가 FALSE 이고 새 파일이 이미 있는 경우 함수는 기존 파일을 덮어쓰고 성공합니다.

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.


지원되는 최소 클라이언트	Windows 10, 버전 1803
머리글	fileapifromapp.h