Skip to main content

IXtfFileIOClient::CopyFiles 메서드

개발 콘솔의 두 위치 간에 파일을 복사하고 작업에 대한 정보를 반환합니다.

구문

매개 변수

pszSearchPattern
형식: LPCWSTR
복사할 원본 파일의 파일 이름을 정의하는 검색 패턴에 대한 포인터입니다. 이 매개 변수는 지정된 패턴과 일치하는 문자열을 위해 와일드카드 문자를 허용합니다. dwIncludeAttributes
형식: DWORD
복사에 포함할 파일 특성의 비트별 OR 조합입니다. 가능한 특성 목록은 파일 특성 상수를 참조하세요. dwExcludeAttributes
형식: DWORD
복사에서 제외할 파일 특성의 비트별 OR 조합입니다. 가능한 특성 목록은 파일 특성 상수를 참조하세요. dwRecursionLevels
형식: DWORD
복사에서 재귀할 디렉터리 수준 수 또는 디렉터리 트리의 모든 수준을 포함할 -1입니다. pszDstFileName
형식: LPCWSTR
복사할 대상 파일의 파일 이름에 대한 포인터입니다. dwFlags
형식: DWORD
파일을 복사하는 방법을 지정하는 플래그입니다. 다음 표에 나열된 매크로의 비트별 OR 조합입니다. pCallback
형식: IXtfCopyFileCallback*
복사 상태가 변경될 때 호출할 IXtfCopyFileCallback 콜백에 대한 포인터입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

설명

IXtfFileIOClient::CopyFiles는 XBOX 콘솔의 한 위치에서 다른 위치로 파일을 복사하는 프로세스를 시작합니다. 파일 복사 명령의 진행 상황을 추적하려면 IXtfCopyFileCallback 인스턴스로 콜백 함수를 정의합니다. IXtfCopyFileCallback에는 파일 복사 작업이 시작될 때, 진행 중일 때, 마지막으로 완료된 후에 호출되는 콜백 함수가 포함되어 있습니다.
와일드카드 문자를 사용하여 여러 파일을 복사할 때 pszDstFileName 매개 변수는 디렉터리로 간주되며 복사된 모든 파일이 해당 디렉터리에 배치됩니다. 디렉터리가 없으면 파일이 복사되기 전에 만들어집니다.
dwIncludeAttributesdwExcludeAttributes 매개 변수는 어떤 파일이 복사되는지 나타내는 필터 역할을 합니다. 이러한 매개 변수는 파일을 복사할 때 어떤 파일 특성이 복사되는지 나타내는 필터로는 작동하지 않습니다.

요구 사항

헤더: xtffileio.h 라이브러리: xtffileio.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)

함께 보기

IXtfFileIOClient 인터페이스
XtfFileIO
마지막 수정일 2026년 8월 24일