Metodo IBackgroundCopyCallback::JobError

Articolo
06/12/2023

Ottimizzazione recapito chiama l'implementazione del metodo JobError quando lo stato del processo viene modificato in BG_JOB_STATE_ERROR.

Sintassi

HRESULT JobError(
  [in] IBackgroundCopyJob   *pJob,
  [in] IBackgroundCopyError *pError
);

Parametri

pJob [in]: Contiene informazioni correlate al processo, ad esempio il numero di byte e file trasferiti prima dell'errore. Contiene anche i metodi per riprendere e annullare il processo. Non rilasciare pJob; Ottimizzazione recapito rilascia l'interfaccia quando il metodo JobError restituisce.
pError [in]: Contiene informazioni sull'errore, ad esempio il file elaborato al momento dell'errore irreversibile e una descrizione dell'errore. Non rilasciare pError; Ottimizzazione recapito rilascia l'interfaccia quando il metodo JobError restituisce.

Valore restituito

Questo metodo deve restituire S_OK; in caso contrario, Ottimizzazione recapito continua a chiamare questo metodo fino a quando non viene restituito S_OK. Per motivi di prestazioni, è consigliabile limitare il numero di volte in cui si restituisce un valore diverso da S_OK a poche volte. In alternativa alla restituzione di un codice di errore, è consigliabile restituire sempre S_OK e gestire internamente l'errore. L'intervallo in cui viene chiamato questo metodo è arbitrario.

Commenti

Dopo aver determinato la causa dell'errore, eseguire una delle opzioni seguenti:

Per annullare il processo, chiamare il metodo IBackgroundCopyJob::Cancel .
Per accettare la parte del processo che è stata trasferita correttamente prima dell'errore, chiamare il metodo IBackgroundCopyJob::Complete . Questa opzione non si applica ai processi di caricamento; non è possibile completare una parte di un processo di caricamento.
Per completare l'elaborazione del processo, risolvere il problema e quindi chiamare il metodo IBackgroundCopyJob::Resume .

Gli errori temporanei non generano chiamate al metodo JobError .

Ottimizzazione recapito restituisce BG_ERROR_CONTEXT_REMOTE_FILE se il processo ha raggiunto un errore HTTP 403, BG_ERROR_CONTEXT_NONE in caso contrario.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1709 [solo app desktop]
Server minimo supportato	Windows Server, versione 1709 [solo app desktop]
Intestazione	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Libreria	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyCallback è definito come 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22

Vedi anche

IBackgroundCopyCallback
IBackgroundCopyError
IBackgroundCopyJob
IBackgroundCopyJob::Cancel
IBackgroundCopyJob::Resume