IBackgroundCopyCallback1::OnStatus-Methode (qmgr.h)

Artikel
03/01/2024

[IBackgroundCopyCallback1 ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die BITS-Schnittstellen.]

Implementieren Sie die OnStatus-Methode , um Benachrichtigungen zu erhalten, wenn die Gruppe abgeschlossen ist oder ein Fehler auftritt.

Syntax

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

Parameter

[in] pGroup

Schnittstellenzeiger auf die Gruppe, die das Ereignis generiert hat.

[in] pJob

Schnittstellenzeiger auf den Auftrag, der dem Ereignis oder NULL zugeordnet ist, wenn das Ereignis nicht einem Auftrag zugeordnet ist.

[in] dwFileIndex

Indizieren Sie die Datei, die dem Fehler oder -1 zugeordnet ist. Um die Datei abzurufen, rufen Sie die IBackgroundCopyJob1::GetFile-Methode auf.

[in] dwStatus

Der Status der Gruppe. Der Status der Gruppe ist entweder abgeschlossen (alle Aufträge in der Gruppe wurden heruntergeladen) oder fehlerbehaftet. Ein Fehler ist aufgetreten, wenn das QM_STATUS_GROUP_ERROR-Flag festgelegt ist. Andernfalls ist die Gruppe abgeschlossen.

[in] dwNumOfRetries

Die Anzahl der Versuchten von QMGR, die Gruppe herunterzuladen, nachdem ein Fehler aufgetreten ist. Nur gültig, wenn das QM_STATUS_GROUP_ERROR dwStatus-Flag festgelegt ist.

[in] dwWin32Result

Win32-Fehlercode. Nur gültig, wenn das QM_STATUS_GROUP_ERROR dwStatus-Flag festgelegt ist.

[in] dwTransportResult

HTTP-Fehlercode. Nur gültig, wenn das QM_STATUS_GROUP_ERROR dwStatus-Flag festgelegt ist.

Rückgabewert

Diese Methode sollte S_OK zurückgeben. Andernfalls ruft der Dienst diese Methode so lange auf, bis S_OK zurückgegeben wird. Das Intervall, in dem die Implementierung aufgerufen wird, ist willkürlich.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Windows
Kopfzeile	qmgr.h

Weitere Informationen

IBackgroundCopyCallback1

Freigeben über