Pular para o conteúdo principal

Método IXtfCopyFileCallback::OnStartFileCopy

Chamado quando um arquivo começa a ser copiado entre dois locais em um console de desenvolvimento.

Sintaxe

Parâmetros

pszRootDirectory
Tipo: LPCWSTR
Ponteiro para o caminho do diretório raiz da cópia. pszSearchPattern
Tipo: LPCWSTR
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. pSrcFileInfo
Tipo: LPCXTFFILEINFO
Ponteiro para uma estrutura XTFFILEINFO que contém informações sobre o arquivo copiado. pszDstFileName
Tipo: LPCWSTR
Ponteiro para o nome do arquivo de destino.

Valor retornado

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

Comentários

Essa função de retorno de chamada é chamada uma vez pelo método IXtfFileIOClient::CopyFiles no início de uma operação de cópia de arquivo. O tamanho do arquivo retornado na estrutura XTFFILEINFO representa a soma dos tamanhos dos arquivos que precisam ser copiados, em bytes. Você pode usar essa soma para acompanhar o progresso geral da operação de cópia de arquivo. Se essa função de retorno de chamada retornar um código de erro HRESULT, a operação de cópia de arquivo será anulada.

Requisitos

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

Confira também

Interface IXtfCopyFileCallback
XtfFileIO
Última modificação em 6 de outubro de 2026