bits.h-Header

Dieser Header wird vom Intelligenten Hintergrundübertragungsdienst verwendet. Weitere Informationen finden Sie unter

• Intelligenter Hintergrundübertragungsdienst (Background Intelligent Transfer Service, BITS)

bits.h enthält die folgenden Programmierschnittstellen:

Schnittstellen

IBackgroundCopyCallback Implementieren Sie die IBackgroundCopyCallback-Schnittstelle, um eine Benachrichtigung zu erhalten, dass ein Auftrag abgeschlossen ist, geändert wurde oder ein Fehler vorliegt. Clients verwenden diese Schnittstelle, anstatt die status des Auftrags zu abfragen.
IBackgroundCopyError Verwenden Sie die IBackgroundCopyError-Schnittstelle, um die Ursache eines Fehlers zu ermitteln und ob der Übertragungsprozess fortgesetzt werden kann.
IBackgroundCopyFile IBackgroundCopyFile enthält Informationen zu einer Datei, die Teil eines Auftrags ist. Beispielsweise können Sie IBackgroundCopyFile-Methoden verwenden, um die lokalen namen und remotenamen der Datei abzurufen und Statusinformationen zu übertragen.
IBackgroundCopyJob Verwenden Sie die IBackgroundCopyJob-Schnittstelle, um dem Auftrag Dateien hinzuzufügen, die Prioritätsebene des Auftrags festzulegen, den Status des Auftrags zu bestimmen und den Auftrag zu starten und zu beenden.
IBackgroundCopyManager Erstellt Übertragungsaufträge, ruft ein Enumeratorobjekt ab, das die Aufträge in der Warteschlange enthält, und ruft einzelne Aufträge aus der Warteschlange ab.
IEnumBackgroundCopyFiles Verwenden Sie die IEnumBackgroundCopyFiles-Schnittstelle, um die Dateien aufzulisten, die ein Auftrag enthält. Um einen IEnumBackgroundCopyFiles-Schnittstellenzeiger abzurufen, rufen Sie die IBackgroundCopyJob::EnumFiles-Methode auf.
IEnumBackgroundCopyJobs Verwenden Sie die IEnumBackgroundCopyJobs-Schnittstelle, um die Liste der Aufträge in der Übertragungswarteschlange aufzulisten. Um einen IEnumBackgroundCopyJobs-Schnittstellenzeiger abzurufen, rufen Sie die IBackgroundCopyManager::EnumJobs-Methode auf.

Strukturen

BG_FILE_INFO Stellt die lokalen und Remotenamen der zu übertragenden Datei bereit.
BG_FILE_PROGRESS Stellt dateibezogene Statusinformationen bereit, z. B. die Anzahl der übertragenen Bytes.
BG_JOB_PROGRESS Stellt auftragsbezogene Statusinformationen bereit, z. B. die Anzahl der übertragenen Bytes und Dateien.
BG_JOB_TIMES Stellt auftragsbezogene Zeitstempel bereit.

Enumerationen

BG_ERROR_CONTEXT Definiert Konstanten, die den Kontext angeben, in dem der Fehler aufgetreten ist.
BG_JOB_PRIORITY Definiert Konstanten, die die Prioritätsebene eines Auftrags angeben.
BG_JOB_PROXY_USAGE Definiert Konstanten, die angeben, welcher Proxy für Dateiübertragungen verwendet werden soll. Sie können für jeden Auftrag unterschiedliche Proxyeinstellungen definieren.
BG_JOB_STATE Definiert Konstanten, die die verschiedenen Zustände eines Auftrags angeben.
BG_JOB_TYPE Definiert Konstanten, die den Typ des Übertragungsauftrags angeben, z. B. Download.