IXtfFileIOClient::CopyFiles 메서드
개발 콘솔에서 두 위치 사이에 파일을 복사하고 작업에 대한 정보를 반환합니다.
구문
public:
HRESULT CopyFiles(
LPCWSTR pszSearchPattern,
DWORD dwIncludeAttributes,
DWORD dwExcludeAttributes,
DWORD dwRecursionLevels,
LPCWSTR pszDstFileName,
DWORD dwFlags,
IXtfCopyFileCallback *pCallback
)
매개 변수
pszSearchPattern
형식: LPCWSTR
복사할 소스 파일의 파일 이름을 정의하는 검색 패턴에 대한 포인터입니다. 이 매개 변수는 와일드카드 문자를 허용하여 문자열과 표시된 패턴을 일치합니다.
dwIncludeAttributes
형식: DWORD
복사에 포함할 파일 특성의 비트 OR 조합입니다. 가능한 특성 목록은 파일 특성 상수를 참조하세요.
dwExcludeAttributes
형식: DWORD
복사에서 제외할 파일 특성의 비트 OR 조합입니다. 가능한 특성 목록은 파일 특성 상수를 참조하세요.
dwRecursionLevels
형식: DWORD
복사를 반복 수행할 디렉터리 수준 수 또는 디렉터리 트리의 모든 수준을 포함하는 -1입니다.
pszDstFileName
형식: LPCWSTR
복사할 대상 파일의 파일 이름에 대한 포인터입니다.
dwFlags
형식: DWORD
파일 복사 방법을 지정하는 플래그입니다. 다음 표에 나열된 매크로의 비트 OR 조합입니다.
| 값 | 매크로 | 설명 |
|---|---|---|
| 0x80000000 | XTFCOPYFILE_DEFER | 파일 복사를 지연합니다. |
pCallback
형식: IXtfCopyFileCallback*
복사 상태가 변경될 때 호출할 IXtfCopyFileCallback 콜백에 대한 포인터입니다.
반환 값
형식: HRESULT
성공한 경우 S_OK을(를) 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
IXtfFileIOClient::CopyFiles는 Xbox 본체의 한 위치에서 다른 위치로 파일을 복사하는 프로세스를 시작합니다. 파일 복사 명령의 진행 상황을 추적하기 위해 IXtfCopyFileCallback 인스턴스를 사용하여 콜백 함수를 정의합니다.
IXtfCopyFileCallback 파일 복사 작업 시작 시, 이 작업 진행 시, 그리고 마지막으로 완료 후에 호출되는 콜백 함수를 포함합니다.
와일드카드 문자 사용을 통해 여러 파일을 복사할 때 pszDstFileName 매개 변수는 디렉터리로 간주되고 모든 복사 파일은 해당 디렉터리에 위치합니다. 디렉터리가 없는 경우 파일 복사 전에 생성됩니다.
dwIncludeAttributes 및 dwExcludeAttributes 매개 변수는 어떤 파일이 복사되는지를 표시하는 필터로서 역할을 합니다. 이 매개 변수는 파일을 복사할 때 어떤 파일 특성이 복사되는지를 표시하는 필터로서 역할을 하지 않습니다.
요건
헤더: xtffileio.h
라이브러리: xtffileio.lib
지원되는 플랫폼: Windows(Xbox 콘솔 도구용)