Share via


IBackgroundCopyJob::GetErrorCount-Methode (bits.h)

Ruft ab, wie oft BITS versucht hat, den Auftrag zu übertragen, und es ist ein Fehler aufgetreten.

Syntax

HRESULT GetErrorCount(
  [out] ULONG *Errors
);

Parameter

[out] Errors

Anzahl der Fehler, die aufgetreten sind, während BITS versucht hat, den Auftrag zu übertragen. Die Anzahl steigt, wenn der Auftrag vom BG_JOB_STATE_TRANSFERRING Zustand in den BG_JOB_STATE_TRANSIENT_ERROR- oder BG_JOB_STATE_ERROR-Zustand wechselt.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg oder einen der COM HRESULT-Standardwerte für Fehler zurück.

Hinweise

Die Anzahl wird nie zurückgesetzt. Die Anzahl gibt möglicherweise nicht genau an, wie oft der Auftrag in den vorübergehenden Fehler- oder Fehlerzustand wechselt. Beispielsweise erhöht BITS nicht die Anzahl, wenn die Netzwerktrennung auftritt, das Programm zum Überprüfen des Datenträgers ausgeführt wird, oder die Bandbreitenrichtlinie verhindert, dass Aufträge übertragen werden.

BITS erhöht auch die Anzahl jedes Mal, wenn versucht wird, den Auftrag zu übertragen, wenn sich der Auftrag im vorübergehenden Fehlerzustand befindet und der Auftrag fehlschlägt.

BITS 1.5 und früher: BITS erhöht die Anzahl nicht bei jedem Versuch, den Auftrag zu übertragen, wenn er sich im Vorübergehenden Fehlerzustand befindet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP
Unterstützte Mindestversion (Server) Windows Server 2003
Zielplattform Windows
Kopfzeile bits.h
Bibliothek Bits.lib
DLL QmgrPrxy.dll

Weitere Informationen

IBackgroundCopyJob::GetError