Metodo IBackgroundCopyCallback1::OnStatus (qmgr.h)

Articolo
03/05/2024

[IBackgroundCopyCallback1 è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece le interfacce BITS.

Implementare il metodo OnStatus per ricevere una notifica quando il gruppo è completato o si verifica un errore.

Sintassi

HRESULT OnStatus(
  [in] IBackgroundCopyGroup *pGroup,
  [in] IBackgroundCopyJob1  *pJob,
  [in] DWORD                dwFileIndex,
  [in] DWORD                dwStatus,
  [in] DWORD                dwNumOfRetries,
  [in] DWORD                dwWin32Result,
  [in] DWORD                dwTransportResult
);

Parametri

[in] pGroup

Puntatore dell'interfaccia al gruppo che ha generato l'evento.

[in] pJob

Puntatore dell'interfaccia al processo associato all'evento o NULL se l'evento non è associato a un processo.

[in] dwFileIndex

Indicizzare il file associato all'errore o a -1. Per recuperare il file, chiamare il metodo IBackgroundCopyJob1::GetFile .

[in] dwStatus

Stato del gruppo. Lo stato del gruppo è completo (tutti i processi del gruppo sono stati scaricati) o in caso di errore. Si è verificato un errore se il flag di QM_STATUS_GROUP_ERROR è impostato. In caso contrario, il gruppo è completo.

[in] dwNumOfRetries

Numero di volte in cui QMGR ha tentato di scaricare il gruppo dopo un errore. Valido solo se il flag dwStatus QM_STATUS_GROUP_ERROR è impostato.

[in] dwWin32Result

Codice di errore Win32. Valido solo se il flag dwStatus QM_STATUS_GROUP_ERROR è impostato.

[in] dwTransportResult

Codice di errore HTTP. Valido solo se il flag dwStatus QM_STATUS_GROUP_ERROR è impostato.

Valore restituito

Questo metodo deve restituire S_OK; in caso contrario, il servizio continua a chiamare questo metodo fino a quando non viene restituito S_OK. L'intervallo in cui viene chiamata l'implementazione è arbitraria.

Requisiti

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

Vedi anche

IBackgroundCopyCallback1

Condividi tramite