Compartilhar via

Método ITransferAdviseSink::UpdateProgress (shobjidl_core.h)

  • Artigo

Atualizações o progresso da transferência status na interface do usuário.

Sintaxe

HRESULT UpdateProgress(
  [in] ULONGLONG ullSizeCurrent,
  [in] ULONGLONG ullSizeTotal,
  [in] int       nFilesCurrent,
  [in] int       nFilesTotal,
  [in] int       nFoldersCurrent,
  [in] int       nFoldersTotal
);

Parâmetros

[in] ullSizeCurrent

Tipo: ULONGLONG

O número de bytes processados na operação atual.

[in] ullSizeTotal

Tipo: ULONGLONG

O número total de bytes na operação atual.

[in] nFilesCurrent

Tipo: int

O número de arquivos processados na operação atual.

[in] nFilesTotal

Tipo: int

O número total de arquivos na operação. Defina como 0 para indicar que o valor não foi alterado desde a última chamada para esse método.

[in] nFoldersCurrent

Tipo: int

O número de pastas processadas na operação atual.

[in] nFoldersTotal

Tipo: int

O número total de pastas na operação. Defina como 0 para indicar que o valor não foi alterado desde a última chamada para esse método.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Defina ullSizeTotal, nFilesTotal e nFoldersTotal como 0 para indicar que os totais não foram alterados desde a última chamada para esse método.

Defina todos os seis parâmetros como 0 para indicar que o progresso não foi alterado desde a última chamada a esse método.

Observação aos implementadores

Os implementadores dessa função devem retornar um código de erro quando a operação precisar ser encerrada antes de ser concluída, como quando o usuário clica no botão Cancelar .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)