Condividi tramite

Metodo ITransferAdviseSink::UpdateProgress (shobjidl_core.h)

  • Articolo

Aggiornamenti lo stato di avanzamento del trasferimento nell'interfaccia utente.

Sintassi

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

Parametri

[in] ullSizeCurrent

Tipo: ULONGLONG

Numero di byte elaborati nell'operazione corrente.

[in] ullSizeTotal

Tipo: ULONGLONG

Numero totale di byte nell'operazione corrente.

[in] nFilesCurrent

Tipo: int

Numero di file elaborati nell'operazione corrente.

[in] nFilesTotal

Tipo: int

Numero totale di file nell'operazione. Impostare su 0 per indicare che il valore non è cambiato dall'ultima chiamata a questo metodo.

[in] nFoldersCurrent

Tipo: int

Numero di cartelle elaborate nell'operazione corrente.

[in] nFoldersTotal

Tipo: int

Numero totale di cartelle nell'operazione. Impostare su 0 per indicare che il valore non è cambiato dall'ultima chiamata a questo metodo.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Impostare ullSizeTotal, nFilesTotal e nFoldersTotal su 0 per indicare che i totali non sono stati modificati dall'ultima chiamata a questo metodo.

Impostare tutti e sei i parametri su 0 per indicare che lo stato di avanzamento non è cambiato dall'ultima chiamata a questo metodo.

Nota per implementatori

Gli implementatori di questa funzione devono restituire un codice di errore quando l'operazione deve terminare prima del completamento, ad esempio quando l'utente fa clic sul pulsante Annulla .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)