Condividi tramite

IControlProgressHandler

  • Articolo

Questa interfaccia è un gestore lato client che riceve gli aggiornamenti quando la libreria esegue un'operazione. La libreria esegue quindi callback sincroni al client che indica lo stato di avanzamento dell'operazione. A seconda dell'azione dell'utente, il codice restituito dal client indica alla libreria di continuare l'operazione o di annullarla. Questo processo consente all'interfaccia utente di visualizzare l'avanzamento delle operazioni lunghe, ad esempio Salva. Se l'utente sceglie di annullare l'operazione, l'interfaccia utente restituisce il codice corrispondente alla libreria.

Sintassi

{
  [id(1), helpstring("OnBegin")] HRESULT OnBegin();
  [id(2), helpstring("OnUpdate")] HRESULT OnUpdate
    ([in] ULONG CurrentValuePercent);
  [id(3), helpstring("OnEnd")] HRESULT OnEnd
    ([in] HRESULT hrResult);
};

Funzioni

Nella tabella seguente vengono descritte le funzioni fornite da questa interfaccia.

Funzione Descrizione

OnBegin

Indica alla libreria di avviare un'operazione.

OnUpdate

Indica alla libreria di continuare lo stato di avanzamento di un'operazione.

OnEnd

Restituisce un codice di stato dopo la fine di un'operazione.

Interfacce