Metodo ISimilarityReportProgress::ReportProgress (msrdc.h)

Segnala la percentuale di completamento corrente di un'operazione di somiglianza in corso.

Sintassi

HRESULT ReportProgress(
  [in] DWORD percentCompleted
);

Parametri

[in] percentCompleted

Percentuale di completamento corrente dell'attività. L'intervallo valido è compreso tra 0 e 100.

Valore restituito

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

Commenti

Il metodo ISimilarity::CopyAndSwap chiama il metodo ReportProgress per segnalare lo stato di avanzamento dell'operazione di copia e scambio. Per ricevere le informazioni sullo stato di avanzamento, le applicazioni RDC devono implementare questo metodo.

Nessuna garanzia viene effettuata in base alla frequenza con cui viene chiamato questo metodo, né che verrà chiamata con valori specifici per il parametro percentCompleted . Ad esempio, il parametro percentCompleted potrebbe non iniziare a zero e potrebbe non raggiungere mai 100 e potrebbe ricevere lo stesso valore più di una volta. Tuttavia, ogni valore è garantito essere maggiore o uguale al valore precedente.

Se l'applicazione restituisce un codice di errore, ad esempio E_FAIL, l'operazione di somiglianza viene arrestata e il codice di errore viene propagato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	msrdc.h
DLL	MsRdc.dll

Vedi anche

ISimilarityReportProgress