Skip to main content

​
Método IXtfCopyFileCallback::OnFileCopyProgress

Chamado quando o progresso de uma cópia de arquivo muda.

​
Sintaxe

​
Parâmetros

pszSrcFileName
Tipo: LPCWSTR Um ponteiro para o nome do arquivo de origem. Esse parâmetro foi preterido e o valor agora é uma cópia de pszDstFileName. pszDstFileName
Tipo: LPCWSTR Um ponteiro para o nome do arquivo de destino. ullFileSize
Tipo: ULONGLONG O tamanho total do arquivo de origem, em bytes. ullBytesCopied
Tipo: ULONGLONG O número de bytes do arquivo que foram copiados até o momento.

​
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 é chamada pelo método IXtfFileIOClient::CopyFiles para cada pacote transferido durante a operação de cópia de arquivo. A chamada inicial para IXtfCopyFileCallback::OnFileCopyProgress de um arquivo especifica 0 bytes em ullBytesCopied e MAX_FILE_SIZE bytes em ullFileSize. Essa chamada inicial indica que você começou a copiar um novo arquivo. Em seguida, você pode usar as informações de arquivo especificadas nas chamadas subsequentes de IXtfCopyFileCallback::OnFileCopyProgress para acompanhar e exibir o progresso durante a 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
Last modified on October 6, 2026