IBackgroundCopyJob::Complete-Methode
Beendet den Auftrag und speichert die übertragenen Dateien auf dem Client.
Syntax
HRESULT Complete();
Parameter
Diese Methode hat keine Parameter.
Rückgabewert
Diese Methode gibt die folgenden HRESULT-Werte zurück. Die Methode kann auch Fehler im Zusammenhang mit der Umbenennung der temporären Kopien der übertragenen Dateien in ihre Vornamen zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Alle Dateien wurden erfolgreich übertragen. |
|
Bei Downloads kann der Status des Auftrags nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED werden. Für Uploads muss der Status des Auftrags BG_JOB_STATE_TRANSFERRED werden. |
Bemerkungen
Alle Dateien wurden erfolgreich übertragen, wenn der Status des Auftrags BG_JOB_STATE_TRANSFERRED ist. Um den Status des Auftrags zu überprüfen, rufen Sie die IBackgroundCopyJob::GetState-Methode auf. Sie können auch die IBackgroundCopyCallback-Schnittstelle implementieren, um Benachrichtigungen zu erhalten, wenn alle Dateien an den Client übertragen wurden.
Die Übermittlungsoptimierung behält nur Aufträge mit weniger als 30 Tagen bei. Alle älteren Aufträge werden entfernt. Die Übermittlungsoptimierung unterstützt den JobInactivityTimeout-Gruppenrichtlinie nicht.
Bei Downloadaufträgen können Sie während des Übertragungsprozesses jederzeit die Complete-Methode aufrufen. Es werden jedoch nur Dateien gespeichert, die vor dem Aufrufen dieser Methode erfolgreich an den Client übertragen wurden. Wenn Sie beispielsweise die Complete-Methode aufrufen, während die Übermittlungsoptimierung die dritte von fünf Dateien verarbeitet, werden nur die ersten beiden Dateien gespeichert. Um zu ermitteln, welche Dateien übertragen wurden, rufen Sie die IBackgroundCopyFile::GetProgress-Methode auf, und vergleichen Sie das BytesTransferred-Element mit dem BytesTotal-Member der BG_FILE_PROGRESS-Struktur .
Bei Uploadaufträgen können Sie die Complete-Methode nur aufrufen, wenn der Status des Auftrags BG_JOB_STATE_TRANSFERRED ist.
Der Besitzer der Datei ist der Benutzer, der den Aufruf getätigt hat. Wenn beispielsweise ein Administrator die Aufgabe einer anderen Person erledigt, ist die Datei nicht der Besitzer des Auftrags, der Administrator.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 10, Version 1709 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server, Version 1709 [nur Desktop-Apps] |
| Header |
|
| IDL |
|
| Bibliothek |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob ist definiert als 37668D37-507E-4160-9316-26306D150B12 |