Skip to main content

Método IXtfFileIOClient::CopyFiles

Copia arquivos entre dois locais em um console de desenvolvimento e retorna informações sobre a operação.

Sintaxe

Parâmetros

pszSearchPattern
Tipo: LPCWSTR
Um ponteiro para o padrão de pesquisa que define os nomes dos arquivos de origem a serem copiados. Esse parâmetro aceita caracteres curinga para corresponder a cadeias de caracteres com o padrão indicado. dwIncludeAttributes
Tipo: DWORD
Uma combinação OR bit a bit de atributos de arquivo a serem incluídos na cópia. Consulte Constantes de atributo de arquivo para obter uma lista dos atributos possíveis. dwExcludeAttributes
Tipo: DWORD
Uma combinação OR bit a bit de atributos de arquivo a serem excluídos da cópia. Consulte Constantes de atributo de arquivo para obter uma lista dos atributos possíveis. dwRecursionLevels
Tipo: DWORD
O número de níveis de diretório a serem percorridos recursivamente na cópia, ou -1 para abranger todos os níveis da árvore de diretórios. pszDstFileName
Tipo: LPCWSTR
Um ponteiro para os nomes dos arquivos de destino para os quais copiar. dwFlags
Tipo: DWORD
Sinalizadores que especificam como copiar os arquivos. É uma combinação OR bit a bit das macros listadas na tabela a seguir. pCallback
Tipo: IXtfCopyFileCallback*
Um ponteiro para o retorno de chamada IXtfCopyFileCallback a ser chamado quando o status da cópia mudar.

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

Comentários

IXtfFileIOClient::CopyFiles inicia o processo de cópia de um ou mais arquivos de um local para outro no console XBOX. Para acompanhar o progresso do comando de cópia de arquivo, defina as funções de retorno de chamada com uma instância de IXtfCopyFileCallback. IXtfCopyFileCallback contém funções de retorno de chamada que são chamadas quando a operação de cópia de arquivo começa, quando progride e, por fim, depois de terminar.
Ao copiar vários arquivos usando caracteres curinga, presume-se que o parâmetro pszDstFileName seja um diretório, e todos os arquivos copiados são colocados nesse diretório. Se o diretório não existir, ele será criado antes da cópia dos arquivos.
Os parâmetros dwIncludeAttributes e dwExcludeAttributes atuam como filtros que indicam quais arquivos são copiados. Esses parâmetros não atuam como filtros que indicam quais atributos de arquivo são copiados ao copiar arquivos.

Requisitos

Cabeçalho: xtffileio.h Biblioteca: xtffileio.lib Plataformas com suporte: Windows (para ferramentas do console XBOX)

Confira também

Interface IXtfFileIOClient
XtfFileIO
Last modified on October 6, 2026