Condividi tramite


Metodo IBackgroundCopyCallback::JobModification (bits.h)

BITS chiama l'implementazione del metodo JobModification quando il processo è stato modificato. Il servizio genera questo evento quando vengono trasferiti i byte, i file sono stati aggiunti al processo, le proprietà sono state modificate o lo stato del processo è stato modificato.

Sintassi

HRESULT JobModification(
  [in] IBackgroundCopyJob *pJob,
  [in] DWORD              dwReserved
);

Parametri

[in] pJob

Contiene i metodi per accedere alle informazioni sulla proprietà, sullo stato e sullo stato del processo. Non rilasciare pJob; BITS rilascia l'interfaccia quando viene restituito il metodo JobModification .

[in] dwReserved

Riservato per utilizzi futuri.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

L'implementazione potrebbe non ricevere tutti gli eventi di modifica in condizioni di carico massimo delle risorse.

BITS genera un volume elevato di eventi di modifica; è consigliabile creare un timer e eseguire il polling per informazioni sullo stato e sullo stato o limitare l'uso di questo callback. Se si usa questo callback, mantenere breve l'implementazione.

BITS non genera un evento di modifica quando lo stato del processo viene modificato in BG_JOB_STATE_ERROR o BG_JOB_STATE_TRANSFERRED.

Nota BITS supporta fino a quattro notifiche simultanee per utente. Se una o più applicazioni bloccano la restituzione di tutte e quattro le notifiche per un utente, un'applicazione in esecuzione con lo stesso utente non riceverà notifiche finché non viene restituita una o più delle notifiche di blocco.
 

Esempio

Vedere il codice di esempio per l'interfaccia IBackgroundCopyCallback .

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Piattaforma di destinazione Windows
Intestazione bits.h

Vedi anche

IBackgroundCopyCallback

IBackgroundCopyJob