IXtfDeployCallback::OnDeployFileProgress
Retorno de chamada invocado para relatar o progresso da implantação de um arquivo no console.Sintaxe
Parâmetros
pszFilePathTipo: LPCWSTR O caminho do arquivo que está sendo implantado. ullBytesTransferred
Tipo: ULONGLONG O número de bytes transferidos até o momento. ullFileSize
Tipo: ULONGLONG O tamanho total do arquivo que está sendo transferido, em bytes.
Valor retornado
Tipo: HRESULT RetornaS_OK para continuar a implantação ou um código de erro HRESULT para cancelar a implantação.
Comentários
Esse retorno de chamada é invocado quando o sistema de implantação transfere arquivos do PC que está fazendo a implantação para o console. Esse retorno de chamada é chamado uma vez para cada bloco de buffer transferido com êxito para um arquivo. Esse retorno de chamada é sempre invocado pelo menos duas vezes para cada arquivo transferido com êxito: uma vez no início da implantação e uma vez no final da implantação. Se um arquivo de comprimento zero for implantado, ambas as invocações relatarão que zero bytes de zero bytes foram transferidos. Para obter mais informações sobre como os arquivos são avaliados e quando os retornos de chamada são invocados durante o processo de implantação, confira Interface IXtfDeployCallback.O processo de transferência de arquivos para implantação usa vários threads. Seu código deve garantir que correlacione as mensagens de progresso por
pszFilePath e se proteja contra problemas típicos de multithreading.IXtfDeployCallback, o processo de implantação continuará se esse retorno de chamada retornar S_OK. Se esse retorno de chamada retornar qualquer código de erro HRESULT, o processo de implantação será cancelado imediatamente. Os arquivos que já foram transferidos ou excluídos permanecem como estão, e os arquivos transferidos parcialmente são fechados em sua forma truncada. Outra implantação deve ser concluída para garantir que todos os arquivos no console estejam completos e atualizados.
Requisitos
Cabeçalho: xtfapplication.h Biblioteca: xtfapplication.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)Confira também
Interface IXtfDeployCallbackXtfApplication