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

Artikel
08/22/2023

Übersicht über die Intelligent Transfer Service-Technologie im Hintergrund.

Zum Entwickeln des Intelligenten Hintergrundübertragungsdiensts benötigen Sie die folgenden Header:

Programmieranleitungen für diese Technologie finden Sie unter:

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

Enumerationen


BG_AUTH_SCHEME Definiert Konstanten, die das Authentifizierungsschema angeben, das verwendet werden soll, wenn ein Proxy oder Server die Benutzerauthentifizierung anfordert.
BG_AUTH_TARGET Definiert Konstanten, die angeben, ob die Anmeldeinformationen für Proxy- oder Serverbenutzerauthentifizierungsanforderungen verwendet werden.
BG_CERT_STORE_LOCATION Definiert Konstanten, die den Speicherort des Zertifikatspeichers angeben.
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.
BITS_FILE_PROPERTY_ID Definiert Konstanten, die ID-Werte angeben, die den Eigenschaften der Hintergrundkopiedatei entsprechen.
BITS_JOB_PROPERTY_ID Definiert Konstanten, die die ID der Eigenschaft für den BITS-Auftrag angeben.
BITS_JOB_TRANSFER_POLICY Definiert Konstanten, die ID-Werte angeben, die BITS-Eigenschaften entsprechen.
GROUPPROP Die GROUPPROP-Enumeration definiert die konstanten Werte zum Abrufen und Festlegen von Gruppeneigenschaftenwerten.

Functions


Addfile Fügt dem Auftrag eine einzelne Datei hinzu.
AddFiles Verwenden Sie die AddFiles-Methode, um eine oder mehrere Dateien hinzuzufügen, die dem Auftrag heruntergeladen werden sollen.
AddFileSet Fügt einem Auftrag mehrere Dateien hinzu.
AddFileWithRanges Fügt einem Downloadauftrag eine Datei hinzu und gibt die Bereiche der Datei an, die Sie herunterladen möchten.
Abbrechen Löscht den Auftrag aus der Übertragungswarteschlange und entfernt zugehörige temporäre Dateien vom Client (Downloads) und Server (Uploads).
CancelGroup Verwenden Sie die CancelGroup-Methode, um die Gruppe aus der Warteschlange zu entfernen. Dateien, die vor dem Aufrufen dieser Methode vollständig heruntergeladen wurden, stehen dem Client zur Verfügung. Sie können eine Gruppe jederzeit kündigen. Die Gruppe kann jedoch nicht wiederhergestellt werden, nachdem sie abgebrochen wurde.
ClearHelperToken Verwirft das Hilfstoken und ändert die Verwendungsflags nicht.
ClearPeers Entfernt alle Peers aus der Liste der Peers, die Inhalte bereitstellen können.
ClearRecords Entfernt alle Datensätze und Dateien aus dem Cache.
Klonen Erstellt einen weiteren IEnumBackgroundCopyFiles-Enumerator, der den gleichen Enumerationszustand wie der aktuelle enthält.
Klonen Erstellt einen weiteren IEnumBackgroundCopyJobs-Enumerator, der den gleichen Enumerationszustand wie der aktuelle enthält.
Klonen Erstellt einen weiteren IEnumBitsPeerCacheRecords-Enumerator, der den gleichen Enumerationszustand wie der aktuelle enthält.
Klonen Erstellt einen weiteren IEnumBitsPeers-Enumerator, der den gleichen Enumerationszustand wie der aktuelle enthält.
Klonen Verwenden Sie die Clone-Methode, um einen weiteren IEnumBackgroundCopyGroups-Enumerator zu erstellen, der den gleichen Enumerationszustand wie der aktuelle enthält.
Klonen Verwenden Sie die Clone-Methode, um einen weiteren IEnumBackgroundCopyJobs1-Enumerator zu erstellen, der den gleichen Enumerationszustand wie der aktuelle enthält.
Abgeschlossen Beendet den Auftrag und speichert die übertragenen Dateien auf dem Client.
CreateGroup Verwenden Sie die CreateGroup-Methode, um eine neue Gruppe zu erstellen und sie der Downloadwarteschlange hinzuzufügen.
CreateJob Erstellt einen Auftrag.
CreateJob Verwenden Sie die CreateJob-Methode, um der Gruppe einen neuen Auftrag hinzuzufügen. Eine Gruppe darf nur einen Auftrag enthalten.
DeleteRecord Löscht einen Datensatz und eine Datei aus dem Cache. Diese Methode verwendet den Bezeichner des Datensatzes, um den zu löschenden Datensatz zu identifizieren.
DeleteUrl Löscht alle Cachedatensätze und die Datei aus dem Cache für die angegebene URL.
DisableBITSUploads Verwenden Sie die DisableBITSUploads-Methode, um den BITS-Upload in dem virtuellen Verzeichnis zu deaktivieren, auf das das ADSI-Objekt verweist. Diese Methode legt die IIS-Erweiterungseigenschaft BITSUploadEnabled fest.
DiscoverPeers Generiert eine Liste von Peers, die Inhalte bereitstellen können.
EnableBITSUploads Verwenden Sie die EnableBITSUploads-Methode, um den BITS-Upload für das virtuelle Verzeichnis zu aktivieren, auf das das ADSI-Objekt verweist. Diese Methode legt die IIS-Erweiterungseigenschaft BITSUploadEnabled fest.
EnumFiles Ruft einen IEnumBackgroundCopyFiles-Schnittstellenzeiger ab, den Sie zum Aufzählen der Dateien in einem Auftrag verwenden.
EnumGroups Verwenden Sie die EnumGroups-Methode, um eine Liste von Gruppen abzurufen, die dem aktuellen Benutzer gehören. Wenn der aktuelle Benutzer über Administratorrechte verfügt, gibt die Methode alle Gruppen in der Warteschlange zurück.
EnumJobs Ruft einen Schnittstellenzeiger auf ein Enumeratorobjekt ab, das Sie zum Aufzählen der Aufträge in der Übertragungswarteschlange verwenden. Die Reihenfolge der Aufträge im Enumerator ist beliebig.
EnumJobs Verwenden Sie die EnumJobs-Methode, um eine Liste der Aufträge in der Gruppe abzurufen. Die Liste enthält nur einen Auftrag.
EnumPeers Ruft einen IEnumBitsPeers-Schnittstellenzeiger ab, mit dem Sie die Peers auflisten, die Inhalte bereitstellen können. Die Enumeration ist eine Momentaufnahme der Datensätze im Cache.
EnumRecords Ruft einen IEnumBitsPeerCacheRecords-Schnittstellenzeiger ab, den Sie zum Aufzählen der Datensätze im Cache verwenden. Die Enumeration ist eine Momentaufnahme der Datensätze im Cache.
FileRangesTransferred BITS ruft Ihre Implementierung der FileRangesTransferred-Methode auf, wenn mindestens ein Dateibereich heruntergeladen wurde. Dateibereiche werden dem Auftrag mithilfe der IBackgroundCopyFile6::RequestFileRanges-Methode hinzugefügt.
FileTransferred BITS ruft Ihre Implementierung der FileTransferred-Methode auf, wenn BITS die Übertragung einer Datei erfolgreich abgeschlossen hat.
get_GroupID Verwenden Sie die get_GroupID-Methode, um den Bezeichner der Gruppe abzurufen.
get_JobID Verwenden Sie die get_JobID-Methode, um den Bezeichner des Auftrags abzurufen.
get_Size Verwenden Sie die get_Size-Methode, um die Größe aller Dateien in der Gruppe abzurufen, die heruntergeladen werden sollen.
GetCleanupTask Verwenden Sie die GetCleanupTask-Methode, um einen Schnittstellenzeiger auf den Bereinigungstask abzurufen, der dem virtuellen Verzeichnis zugeordnet ist.
GetCleanupTaskName Verwenden Sie die GetCleanupTaskName-Methode, um den Namen der Bereinigungsaufgabe abzurufen, die dem virtuellen Verzeichnis zugeordnet ist.
GetClientCertificate Ruft das Clientzertifikat aus dem Auftrag ab.
GetConfigurationFlags Ruft die Konfigurationsflags ab, die bestimmen, ob der Computer Inhalte an Peers bereitstellt und Inhalte von Peers herunterladen kann.
GetCount Ruft die Anzahl der Dateien in der Enumeration ab.
GetCount Ruft die Anzahl der Aufträge in der Enumeration ab.
GetCount Ruft die Anzahl der Cacheeinträge in der Enumeration ab.
GetCount Ruft die Anzahl der Peers in der Enumeration ab.
GetCount Verwenden Sie die GetCount-Methode, um die Anzahl der Gruppen in der Enumeration abzurufen.
GetCount Verwenden Sie die GetCount-Methode, um die Anzahl der Aufträge in der Enumeration abzurufen.
GetCustomHeaders Ruft die benutzerdefinierten Header ab, die durch einen früheren Aufruf von IBackgroundCopyJobHttpOptions::SetCustomHeaders festgelegt wurden (d. h. Header, die BITS an den Remotecomputer sendet, nicht Header, die BITS vom Remotecomputer empfängt).
GetDescription Ruft die Beschreibung des Auftrags ab.
GetDisplayName Ruft den Anzeigenamen für den Auftrag ab. In der Regel verwenden Sie den Anzeigenamen, um den Auftrag in einer Benutzeroberfläche zu identifizieren.
GetError Ruft den Fehlercode ab und identifiziert den Kontext, in dem der Fehler aufgetreten ist.
GetError Ruft die Fehlerschnittstelle ab, nachdem ein Fehler auftritt.
GetErrorContextDescription Ruft die Beschreibung des Kontexts ab, in dem der Fehler aufgetreten ist.
GetErrorCount Ruft ab, wie oft BITS versucht hat, den Auftrag zu übertragen, und es ist ein Fehler aufgetreten.
GetErrorDescription Ruft den dem Fehler zugeordneten Fehlertext ab.
GetErrorDescription Ruft eine Beschreibung für den angegebenen Fehlercode ab.
Getfile Ruft einen Schnittstellenzeiger auf das Dateiobjekt ab, das dem Fehler zugeordnet ist.
Getfile Verwenden Sie die GetFile-Methode, um die Remote- und lokalen Dateinamen für die angegebene Datei im Auftrag abzurufen.
GetFileACLFlags Ruft die Flags ab, die die Besitzer- und ACL-Informationen identifizieren, die beim Übertragen einer Datei mit SMB beibehalten werden sollen.
GetFileCount Verwenden Sie die GetFileCount-Methode, um die Anzahl der Dateien im Auftrag abzurufen.
GetFileModificationTime Ruft das Datum und die Uhrzeit der letzten Änderung der Datei auf dem Server ab.
GetFileRanges Ruft die Bereiche der Datei ab, die sich im Cache befinden.
GetFileRanges Ruft die Bereiche ab, die Sie aus der Remotedatei herunterladen möchten.
GetFileSize Ruft die Größe der Datei ab.
GetFilledFileRanges Gibt den Satz von Dateibereichen zurück, die heruntergeladen wurden.
GetGroup Verwenden Sie die GetGroup-Methode, um eine Gruppe aus der Downloadwarteschlange abzurufen.
GetHelperTokenFlags Gibt die Verwendungsflags für ein Token zurück, das einem BITS-Übertragungsauftrag zugeordnet ist.
GetHelperTokenSid Gibt die SID des Hilfstokens zurück, wenn eins festgelegt ist.
GetHttpMethod Ruft eine breite Zeichenfolge ab, die den HTTP-Methodennamen für die BITS-Übertragung enthält. Standardmäßig sind Downloadaufträge "GET" und Upload- und Upload-Antwortaufträge "BITS_POST".
Getid Ruft den Bezeichner ab, der zum Identifizieren des Auftrags in der Warteschlange verwendet wird.
Getid Ruft den Bezeichner ab, der den Datensatz im Cache eindeutig identifiziert.
GetJob Ruft einen angegebenen Auftrag aus der Übertragungswarteschlange ab. In der Regel behält Ihre Anwendung den Auftragsbezeichner bei, sodass Sie den Auftrag später aus der Warteschlange abrufen können.
GetJob Verwenden Sie die GetJob-Methode, um einen Auftrag aus der Gruppe abzurufen.
GetLastAccessTime Ruft das Datum und die Uhrzeit ab, zu dem zuletzt auf die Datei zugegriffen wurde.
GetLocalName Ruft den lokalen Namen der Datei ab.
GetMaximumCacheSize Ruft die maximale Größe des Caches ab.
GetMaximumContentAge Ruft das Alter ab, nach dem Dateien aus dem Cache entfernt werden.
GetMaximumDownloadTime Ruft die maximale Zeit ab, die BITS für die Übertragung der Dateien im Auftrag aufwendet.
GetMinimumRetryDelay Ruft die Mindestdauer ab, die der Dienst wartet, nachdem eine vorübergehende Fehlerbedingung aufgetreten ist, bevor versucht wird, die Datei zu übertragen.
GetNoProgressTimeout Ruft die Dauer ab, die der Dienst versucht, die Datei zu übertragen, nachdem eine vorübergehende Fehlerbedingung aufgetreten ist. Wenn Fortschritt vorhanden ist, wird der Timer zurückgesetzt.
GetNotifyCmdLine Ruft das Programm ab, das ausgeführt werden soll, wenn der Auftrag in den Fehler- oder übertragenen Zustand wechselt.
GetNotifyFlags Ruft die Ereignisbenachrichtigungsflags für den Auftrag ab.
GetNotifyInterface Ruft den Schnittstellenzeiger auf Ihre Implementierung der IBackgroundCopyCallback-Schnittstelle ab.
GetObject Verwenden Sie die GetObject-Methode, um einen Zeiger auf die IBITSExtensionSetup-Schnittstelle abzurufen. Diese Methode führt dieselbe Bindung wie die ADsGetObject ADSI-Funktion aus.
GetOriginUrl Ruft die Ursprungs-URL der zwischengespeicherten Datei ab.
GetOwner Ruft die Identität des Auftragsbesitzers ab.
GetOwnerElevationState Ruft einen Wert ab, der bestimmt, ob das Token des Besitzers zu dem Zeitpunkt erhöht wurde, zu dem er den Auftrag erstellt hat oder den Besitz des Auftrags übernommen hat.
GetOwnerIntegrityLevel Ruft die Integritätsebene des Tokens des Besitzers ab, der den Auftrag erstellt oder übernommen hat.
GetPeerCachingFlags Ruft Flags ab, die bestimmen, ob die Dateien des Auftrags zwischengespeichert und an Peers bereitgestellt werden können und ob BITS Inhalte für den Auftrag von Peers herunterladen kann.
GetPeerDownloadStats Gibt Statistiken über die Menge der von Peers und Ursprungsservern heruntergeladenen Daten an.
GetPeerName Ruft den Serverprinzipalnamen ab, der den Peer eindeutig identifiziert.
GetPriority Ruft die Prioritätsebene für den Auftrag ab. Die Prioritätsebene bestimmt, wann der Auftrag relativ zu anderen Aufträgen in der Übertragungswarteschlange verarbeitet wird.
GetProgress Ruft Informationen zum Fortschritt der Dateiübertragung ab.
GetProgress Ruft auftragsbezogene Statusinformationen ab, z. B. die Anzahl der übertragenen Bytes und Dateien.
GetProgress Verwenden Sie die GetProgress-Methode, um den Fortschritt des Downloads abzurufen.
GetProgress Verwenden Sie die GetProgress-Methode, um den Status des Auftrags abzurufen.
GetProp Verwenden Sie die GetProp-Methode, um einen Eigenschaftswert aus der Gruppe abzurufen.
GetProperty Ruft eine generische Eigenschaft einer BITS-Dateiübertragung ab.
GetProperty Eine generische Methode zum Abrufen von BITS-Auftragseigenschaften.
GetProtocol Ruft das Protokoll ab, das zum Übertragen der Datei verwendet wird. Der Remotedateiname gibt das Protokoll an, das zum Übertragen der Datei verwendet werden soll.
GetProxySettings Ruft die Proxyinformationen ab, die der Auftrag zum Übertragen der Dateien verwendet.
GetRecord Ruft einen Datensatz aus dem Cache ab.
GetRemoteName Ruft den Remotenamen der Datei ab.
GetReplyData Ruft eine Im-Arbeitsspeicher-Kopie der Antwortdaten aus der Serveranwendung ab. Rufen Sie diese Methode nur auf, wenn der Typ des Auftrags BG_JOB_TYPE_UPLOAD_REPLY und sein Zustand BG_JOB_STATE_TRANSFERRED ist.
GetReplyFileName Ruft den Namen der Datei ab, die die Antwortdaten aus der Serveranwendung enthält. Rufen Sie diese Methode nur auf, wenn der Auftragstyp BG_JOB_TYPE_UPLOAD_REPLY ist.
GetReplyProgress Ruft Statusinformationen im Zusammenhang mit der Übertragung der Antwortdaten aus einem Upload-Antwort-Auftrag ab.
GetSecurityFlags Ruft die Flags für HTTP ab, die bestimmen, ob die Zertifikatsperrliste überprüft und bestimmte Zertifikatfehler ignoriert werden, sowie die Richtlinie, die verwendet werden soll, wenn ein Server die HTTP-Anforderung umleitet.
GetState Ruft den Status des Auftrags ab.
GetStatus Verwenden Sie die GetStatus-Methode, um den Status der Gruppe abzurufen.
GetStatus Verwenden Sie die GetStatus-Methode, um den Status des Auftrags abzurufen.
GetTemporaryName Ruft den vollständigen Pfad der temporären Datei ab, die den Inhalt des Downloads enthält.
GetTimes Ruft auftragsbezogene Zeitstempel ab, z. B. die Zeit, zu der der Auftrag erstellt oder zuletzt geändert wurde.
GetType Ruft den Typ der ausgeführten Übertragung ab, z. B. ein Dateidownload oder -upload.
GetValidationState Ruft den aktuellen Überprüfungsstatus dieser Datei ab.
IsAuthenticated Bestimmt, ob der Peer authentifiziert ist.
IsAvailable Bestimmt, ob der Peer (online) für die Bereitstellung von Inhalten verfügbar ist.
IsDownloadedFromPeer Ruft einen Wert ab, der bestimmt, ob ein Teil der Datei von einem Peer heruntergeladen wurde.
IsFileValidated Bestimmt, ob die Datei überprüft wurde.
JobError BITS ruft Ihre Implementierung der JobError-Methode auf, wenn sich der Status des Auftrags in BG_JOB_STATE_ERROR ändert.
JobModification BITS ruft Ihre Implementierung der JobModification-Methode auf, wenn der Auftrag geändert wurde.
JobTransferred BITS ruft Ihre Implementierung der JobTransferred-Methode auf, wenn alle Dateien im Auftrag erfolgreich übertragen wurden.
MakeCustomHeadersWriteOnly Legt fest, dass die benutzerdefinierten HTTP-Header für diesen Auftrag schreibgeschützt sind.
Nächste Ruft eine angegebene Anzahl von Elementen in der Enumerationsfolge ab. Wenn weniger als die angeforderte Anzahl von Elementen in der Sequenz vorhanden ist, werden die restlichen Elemente abgerufen. (IEnumBackgroundCopyFiles.Next)
Nächste Ruft eine angegebene Anzahl von Elementen in der Enumerationsfolge ab. Wenn weniger als die angeforderte Anzahl von Elementen in der Sequenz vorhanden ist, werden die restlichen Elemente abgerufen. (IEnumBackgroundCopyJobs.Next)
Nächste Ruft eine angegebene Anzahl von Elementen in der Enumerationsfolge ab. Wenn weniger als die angeforderte Anzahl von Elementen in der Sequenz vorhanden ist, werden die restlichen Elemente abgerufen. (IEnumBitsPeerCacheRecords.Next)
Nächste Ruft eine angegebene Anzahl von Elementen in der Enumerationsfolge ab. Wenn weniger als die angeforderte Anzahl von Elementen in der Sequenz vorhanden ist, werden die restlichen Elemente abgerufen. (IEnumBitsPeers.Next)
Nächste Verwenden Sie die Next-Methode, um die angegebene Anzahl von Elementen in der Enumerationssequenz abzurufen. Wenn weniger als die angeforderte Anzahl von Elementen in der Sequenz vorhanden ist, werden die restlichen Elemente abgerufen. (IEnumBackgroundCopyGroups.Next)
Nächste Verwenden Sie die Next-Methode, um die angegebene Anzahl von Elementen in der Enumerationssequenz abzurufen. Wenn weniger als die angeforderte Anzahl von Elementen in der Sequenz vorhanden ist, werden die restlichen Elemente abgerufen. (IEnumBackgroundCopyJobs1.Next)
OnStatus Implementieren Sie die OnStatus-Methode, um Benachrichtigungen zu erhalten, wenn die Gruppe abgeschlossen ist oder ein Fehler auftritt.
RemoveClientCertificate Entfernt das Clientzertifikat aus dem Auftrag.
RemoveCredentials Entfernt Anmeldeinformationen aus der Verwendung. Die Anmeldeinformationen müssen mit einem vorhandenen Ziel- und Schemapaar übereinstimmen, das Sie mit der IBackgroundCopyJob2::SetCredentials-Methode angegeben haben. Es gibt keine Methode zum Abrufen der von Ihnen festgelegten Anmeldeinformationen.
ReplaceRemotePrefix Ersetzt den Anfangstext aller Remotenamen im Downloadauftrag durch die angegebene Zeichenfolge.
RequestFileRanges Fügt eine neue Gruppe von Dateibereichen hinzu, die für den Download priorisiert werden sollen.
Zurücksetzen Setzt die Enumerationsfolge auf den Anfang zurück. (IEnumBackgroundCopyFiles.Reset)
Zurücksetzen Setzt die Enumerationsfolge auf den Anfang zurück. (IEnumBackgroundCopyJobs.Reset)
Zurücksetzen Setzt die Enumerationsfolge auf den Anfang zurück. (IEnumBitsPeerCacheRecords.Reset)
Zurücksetzen Setzt die Enumerationsfolge auf den Anfang zurück. (IEnumBitsPeers.Reset)
Zurücksetzen Verwenden Sie die Reset-Methode, um die Enumerationssequenz auf den Anfang zurückzusetzen. (IEnumBackgroundCopyGroups.Reset)
Zurücksetzen Verwenden Sie die Reset-Methode, um die Enumerationssequenz auf den Anfang zurückzusetzen. (IEnumBackgroundCopyJobs1.Reset)
Fortsetzen Aktiviert einen neuen Auftrag oder startet einen angehaltenen Auftrag neu.
ResumeGroup Verwenden Sie die ResumeGroup-Methode, um eine Gruppe zu starten, die in der Downloadwarteschlange angehalten wurde.
SetClientCertificateByID Gibt den Bezeichner des Client-Zertifikats an, das für die Client-Authentifizierung in einer HTTPS (SSL)-Anfrage verwendet werden soll.
SetClientCertificateByName Gibt den Antragstellernamen des Clientzertifikats an, das für die Clientauthentifizierung in einer HTTPS-Anforderung (SSL) verwendet werden soll.
SetConfigurationFlags Legt die Konfigurationsflags fest, die bestimmen, ob der Computer Inhalte an Peers bereitstellen und Inhalte von Peers herunterladen kann.
Setcredentials Gibt die Anmeldeinformationen an, die für eine Proxy- oder Remoteserver-Benutzerauthentifizierungsanforderung verwendet werden sollen.
SetCustomHeaders Gibt mindestens einen benutzerdefinierten HTTP-Header an, der in HTTP-Anforderungen eingeschlossen werden soll.
SetDescription Enthält eine Beschreibung des Auftrags.
SetDisplayName Gibt einen Anzeigenamen für den Auftrag an. In der Regel verwenden Sie den Anzeigenamen, um den Auftrag in einer Benutzeroberfläche zu identifizieren.
SetFileACLFlags Gibt die Besitzer- und ACL-Informationen an, die verwaltet werden sollen, wenn SMB zum Herunterladen oder Hochladen einer Datei verwendet wird.
SetHelperToken Legt das Hilfstoken fest, um die Identität des Tokens des COM-Clients zu annehmen.
SetHelperTokenFlags Legt die Verwendungsflags für ein Token fest, das einem BITS-Übertragungsauftrag zugeordnet ist.
SetHttpMethod Überschreibt die für eine BITS-Übertragung verwendete HTTP-Standardmethode.
SetMaximumCacheSize Gibt die maximale Größe des Caches an.
SetMaximumContentAge Gibt an, wann Dateien basierend auf dem Alter aus dem Cache entfernt werden.
SetMaximumDownloadTime Legt die maximale Zeit fest, die BITS für die Übertragung der Dateien im Auftrag aufwendet.
SetMinimumRetryDelay Legt die Mindestdauer fest, die BITS wartet, nachdem eine vorübergehende Fehlerbedingung aufgetreten ist, bevor versucht wird, die Datei zu übertragen.
SetNoProgressTimeout Legt die Dauer fest, die BITS versucht, die Datei nach auftreten einer vorübergehenden Fehlerbedingung zu übertragen. Wenn Fortschritt vorhanden ist, wird der Timer zurückgesetzt.
SetNotifyCmdLine Gibt ein Programm an, das ausgeführt werden soll, wenn der Auftrag in den BG_JOB_STATE_ERROR- oder BG_JOB_STATE_TRANSFERRED-Zustand wechselt. BITS führt das Programm im Kontext des Benutzers aus, der diese Methode aufgerufen hat.
SetNotifyFlags Gibt den Typ der Ereignisbenachrichtigung an, die Sie erhalten möchten, z. B. auftragsbasierte Ereignisse.
SetNotifyInterface Identifiziert Ihre Implementierung der IBackgroundCopyCallback-Schnittstelle zu BITS. Verwenden Sie die IBackgroundCopyCallback-Schnittstelle, um Benachrichtigungen über auftragsbezogene Ereignisse zu erhalten.
SetPeerCachingFlags Legt Flags fest, um anzugeben, ob die Dateien eines Auftrags zwischengespeichert und an Peers übermittelt werden können, und ob der Auftrag Inhalte von Peers herunterladen kann.
SetPriority Gibt die Prioritätsebene Ihres Auftrags an. Die Prioritätsebene bestimmt, wann Ihr Auftrag relativ zu anderen Aufträgen in der Übertragungswarteschlange verarbeitet wird.
SetProp Verwenden Sie die SetProp-Methode, um den Eigenschaftswert für eine Group-Eigenschaft festzulegen.
SetProperty Legt eine generische Eigenschaft einer BITS-Dateiübertragung fest.
SetProperty Eine generische Methode zum Festlegen von BITS-Auftragseigenschaften.
SetProxySettings Gibt an, welcher Proxy zum Übertragen von Dateien verwendet werden soll.
SetRemoteName Ändert den Remotenamen in einer neuen URL in einem Downloadauftrag.
SetReplyFileName Gibt den Namen der Datei an, die die Antwortdaten der Serveranwendung enthalten soll. Rufen Sie diese Methode nur auf, wenn der Typ des Auftrags BG_JOB_TYPE_UPLOAD_REPLY ist.
SetSecurityFlags Legt Flags für HTTP fest, die bestimmen, ob die Zertifikatsperrliste überprüft und bestimmte Zertifikatfehler ignoriert werden, sowie die Richtlinie, die verwendet werden soll, wenn ein Server die HTTP-Anforderung umleitet.
SetServerCertificateValidationInterface Serverzertifikate werden gesendet, wenn eine HTTPS-Verbindung geöffnet wird. Verwenden Sie diese Methode, um festzulegen, dass ein Rückruf aufgerufen wird, um diese Serverzertifikate zu überprüfen.
SetValidationState Legt den Überprüfungsstatus dieser Datei fest.
Skip Überspringt die nächste angegebene Anzahl von Elementen in der Enumerationssequenz. Wenn in der Sequenz weniger Elemente übrig sind als die angeforderte Anzahl der zu überspringenden Elemente, überspringt sie das letzte Element in der Sequenz. (IEnumBackgroundCopyFiles.Skip)
Skip Überspringt die nächste angegebene Anzahl von Elementen in der Enumerationssequenz. Wenn in der Sequenz weniger Elemente übrig sind als die angeforderte Anzahl der zu überspringenden Elemente, überspringt sie das letzte Element in der Sequenz. (IEnumBackgroundCopyJobs.Skip)
Skip Überspringt die nächste angegebene Anzahl von Elementen in der Enumerationssequenz. Wenn in der Sequenz weniger Elemente übrig sind als die angeforderte Anzahl der zu überspringenden Elemente, überspringt sie das letzte Element in der Sequenz. (IEnumBitsPeerCacheRecords.Skip)
Skip Überspringt die nächste angegebene Anzahl von Elementen in der Enumerationssequenz. Wenn in der Sequenz weniger Elemente übrig sind als die angeforderte Anzahl der zu überspringenden Elemente, überspringt sie das letzte Element in der Sequenz. (IEnumBitsPeers.Skip)
Skip Verwenden Sie die Skip-Methode, um die nächste angegebene Anzahl von Elementen in der Enumerationssequenz zu überspringen. Wenn in der Sequenz weniger Elemente übrig sind als die angeforderte Anzahl der zu überspringenden Elemente, überspringt sie das letzte Element in der Sequenz. (IEnumBackgroundCopyGroups.Skip)
Skip Verwenden Sie die Skip-Methode, um die nächste angegebene Anzahl von Elementen in der Enumerationssequenz zu überspringen. Wenn in der Sequenz weniger Elemente übrig sind als die angeforderte Anzahl der zu überspringenden Elemente, überspringt sie das letzte Element in der Sequenz. (IEnumBackgroundCopyJobs1.Skip)
Angehalten Hält einen Auftrag an. Neue Aufträge, Fehleraufträge und Aufträge, die die Übertragung von Dateien abgeschlossen haben, werden automatisch angehalten.
SuspendGroup Verwenden Sie die SuspendGroup-Methode, um eine Gruppe in der Downloadwarteschlange anzuhalten. Neue Gruppen, Fehlergruppen oder Gruppen, die den Download abgeschlossen haben, werden automatisch angehalten.
SwitchToForeground Verwenden Sie die SwitchToForeground-Methode, um die Gruppe im Vordergrund und nicht im Hintergrund herunterzuladen.
TakeOwnership Ändert den Besitz des Auftrags in den aktuellen Benutzer.
UpdateDownloadPosition Gibt eine Position an, aus der das Herunterladen fehlender Daten priorisiert werden soll.
ValidateServerCertificate Eine von Ihnen implementierte Rückrufmethode, die aufgerufen wird, damit Sie die Serverzertifikate überprüfen können, die beim Öffnen einer HTTPS-Verbindung gesendet werden.

Schnittstellen


IBackgroundCopyCallback Implementieren Sie die IBackgroundCopyCallback-Schnittstelle, um eine Benachrichtigung zu erhalten, dass ein Auftrag abgeschlossen ist, geändert wurde oder fehlerhaft ist. Clients verwenden diese Schnittstelle, anstatt die status des Auftrags zu abfragen.
IBackgroundCopyCallback1 Implementieren Sie die IBackgroundCopyCallback1-Schnittstelle, um Benachrichtigungen zu erhalten, wenn Ereignisse auftreten.
IBackgroundCopyCallback2 Implementieren Sie diese Schnittstelle, um eine Benachrichtigung zu erhalten, dass der Download einer Datei abgeschlossen wurde.
IBackgroundCopyCallback3 Clients implementieren die IBackgroundCopyCallback3-Schnittstelle, um eine Benachrichtigung zu erhalten, dass der Download von Bereichen einer Datei abgeschlossen ist.
IBackgroundCopyError Verwenden Sie die IBackgroundCopyError-Schnittstelle, um die Ursache eines Fehlers zu ermitteln und ob der Übertragungsvorgang 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 und Remotenamen der Datei abzurufen und Statusinformationen zu übertragen.
IBackgroundCopyFile2 Verwenden Sie die IBackgroundCopyFile2-Schnittstelle, um einen neuen Remotenamen für die Datei anzugeben und die Liste der herunterzuladenden Bereiche abzurufen.
IBackgroundCopyFile3 Verwenden Sie diese Schnittstelle, um den Namen der temporären Datei abzurufen, die den heruntergeladenen Inhalt enthält, und um die Datei zu überprüfen, damit Peers den Inhalt anfordern können.
IBackgroundCopyFile4 Verwenden Sie diese Schnittstelle, um Downloadstatistiken für Peers und Ursprungsserver abzurufen.
IBackgroundCopyFile5 Verwenden Sie diese Schnittstelle, um generische Eigenschaften von BITS-Dateiübertragungen abzurufen oder festzulegen.
IBackgroundCopyFile6 Verwenden Sie diese Schnittstelle, um Dateibereiche für On-Demand-Downloadaufträge anzufordern.
IBackgroundCopyGroup Verwenden Sie die IBackgroundCopyGroup-Schnittstelle, um eine Gruppe zu verwalten. Eine Gruppe enthält Downloadaufträge. Fügen Sie der Gruppe beispielsweise einen Auftrag hinzu, legen Sie die Eigenschaften der Gruppe fest, und starten und beenden Sie die Gruppe in der Downloadwarteschlange.
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.
IBackgroundCopyJob1 Verwenden Sie die IBackgroundCopyJob1-Schnittstelle, um dem Auftrag Dateien hinzuzufügen und die status des Auftrags abzurufen.
IBackgroundCopyJob2 Rufen Sie Antwortdaten aus einem Upload-Antwort-Auftrag ab, ermitteln Sie den Fortschritt der Antwortdatenübertragung an den Client, fordern Sie die Befehlszeilenausführung an, und geben Sie Anmeldeinformationen für Proxy- und Remoteserverauthentifizierungsanforderungen an.
IBackgroundCopyJob3 Verwenden Sie die IBackgroundCopyJob3-Schnittstelle, um Bereiche einer Datei herunterzuladen und das Präfix eines Remotedateinamens zu ändern.
IBackgroundCopyJob4 Verwenden Sie diese Schnittstelle, um die Peerzwischenspeicherung zu aktivieren, die Downloadzeit einzuschränken und die Merkmale des Benutzertokens zu überprüfen.
IBackgroundCopyJob5 Verwenden Sie diese Schnittstelle, um mehrere optionale Verhaltensweisen eines Auftrags abzufragen oder festzulegen.
IBackgroundCopyJobHttpOptions Verwenden Sie diese Schnittstelle, um Clientzertifikate für die zertifikatbasierte Clientauthentifizierung und benutzerdefinierte Header für HTTP-Anforderungen anzugeben.
IBackgroundCopyJobHttpOptions2 Verwenden Sie diese Schnittstelle, um die für eine BITS-Übertragung verwendete HTTP-Methode abzurufen und/oder zu überschreiben.
IBackgroundCopyJobHttpOptions3 Verwenden Sie diese Schnittstelle, um HTTP-Kundenheader auf schreibgeschützt festzulegen, oder um eine von Ihnen implementierte Rückrufmethode für die Überprüfung des Serverzertifikats festzulegen.
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.
IBackgroundCopyQMgr Verwenden Sie die IBackgroundCopyQMgr-Schnittstelle, um eine neue Gruppe zu erstellen, eine vorhandene Gruppe abzurufen oder alle Gruppen in der Warteschlange aufzulisten. Eine Gruppe enthält einen Downloadauftrag.
IBackgroundCopyServerCertificateValidationCallback Serverzertifikate werden gesendet, wenn eine HTTPS-Verbindung geöffnet wird. Verwenden Sie diese Methode, um einen Rückruf zu implementieren, der aufgerufen werden soll, um diese Serverzertifikate zu überprüfen.
IBITSExtensionSetup Verwenden Sie die IBITSExtensionSetup-Schnittstelle, um BITS-Uploads in ein virtuelles Verzeichnis zu aktivieren oder zu deaktivieren.
IBITSExtensionSetupFactory Verwenden Sie die IBITSExtensionSetupFactory-Schnittstelle, um einen Zeiger auf die IBITSExtensionSetup-Schnittstelle abzurufen.
IBitsPeer Verwenden Sie IBitsPeer, um Informationen zu einem Peer in der Nachbarschaft abzurufen.
IBitsPeerCacheAdministration Verwenden Sie IBitsPeerCacheAdministration, um den Pool von Peers zu verwalten, aus dem Sie Inhalte herunterladen können.
IBitsPeerCacheRecord Verwenden Sie IBitsPeerCacheRecord, um Informationen zu einer Datei im Cache abzurufen.
IBitsTokenOptions Verwenden Sie IBitsTokenOptions, um ein Paar von Sicherheitstoken für einen BITS-Übertragungsauftrag (Background Intelligent Transfer Service) zuzuordnen und zu verwalten.
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.
IEnumBackgroundCopyGroups Verwenden Sie die IEnumBackgroundCopyGroups-Schnittstelle, um die Liste der Gruppen in der Downloadwarteschlange aufzulisten. Um einen IEnumBackgroundCopyGroups-Schnittstellenzeiger abzurufen, rufen Sie die IBackgroundCopyQMgr::EnumGroups-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.
IEnumBackgroundCopyJobs1 Verwenden Sie die IEnumBackgroundCopyJobs1-Schnittstelle, um die Liste der Aufträge in einer Gruppe aufzulisten. Um einen IEnumBackgroundCopyJobs1-Schnittstellenzeiger abzurufen, rufen Sie die IBackgroundCopyGroup::EnumJobs-Methode auf.
IEnumBitsPeerCacheRecords Verwenden Sie IEnumBitsPeerCacheRecords, um die Datensätze des Caches aufzulisten.
IEnumBitsPeers Verwenden Sie IEnumBitsPeers, um die Liste der Peers aufzulisten, die BITS ermittelt hat.

Strukturen


BG_AUTH_CREDENTIALS Gibt das Ziel (Proxy oder Server), das Authentifizierungsschema und die Anmeldeinformationen des Benutzers an, die für Benutzerauthentifizierungsanforderungen verwendet werden sollen. Die Struktur wird an die IBackgroundCopyJob2::SetCredentials-Methode übergeben.
BG_AUTH_CREDENTIALS_UNION Gibt die Anmeldeinformationen an, die für das in der BG_AUTH_CREDENTIALS-Struktur angegebene Authentifizierungsschema verwendet werden sollen.
BG_BASIC_CREDENTIALS Die BG_BASIC_CREDENTIALS-Struktur identifiziert den Benutzernamen und das Kennwort für die Authentifizierung.
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_FILE_RANGE Gibt einen Bereich von Bytes an, der aus einer Datei heruntergeladen werden soll.
BG_JOB_PROGRESS Stellt auftragsbezogene Statusinformationen bereit, z. B. die Anzahl der übertragenen Bytes und Dateien.
BG_JOB_REPLY_PROGRESS Stellt Statusinformationen im Zusammenhang mit dem Antwortteil eines Upload-Antwort-Auftrags bereit.
BG_JOB_TIMES Stellt auftragsbezogene Zeitstempel bereit.
BITS_FILE_PROPERTY_VALUE Stellt den Eigenschaftswert einer BITS-Datei bereit.
BITS_JOB_PROPERTY_VALUE Stellt den Eigenschaftswert des BITS-Auftrags basierend auf dem Wert der BITS_JOB_PROPERTY_ID-Enumeration bereit.
FILESETINFO Die FILESETINFO-Struktur identifiziert die Remote- und lokalen Namen der herunterzuladenden Datei.