Dokončení a zrušení úlohy

Chcete-li dokončit úlohu přenosu, zavolejte metodu IBackgroundCopyJob::Complete. U úloh stahování můžete před přenosem všech souborů v úloze volat metodu Complete (před stavem úlohy BG_JOB_STATE_TRANSFERRED). Uživateli jsou k dispozici pouze soubory, které služba BITS úspěšně přenesla do klienta předtím, než zavoláte metodu Complete.

U úloh nahrávání volejte metodu Complete pouze pokud je stav úlohy BG_JOB_STATE_TRANSFERRED. Chcete-li zjistit, kdy je stav úlohy BG_JOB_STATE_TRANSFERRED, dotazování vlastnost stavu úlohy nebo zaregistrovat k přijetí oznámení BG_NOTIFY_JOB_TRANSFERRED událostí.

Pokud chcete zrušit úlohu přenosu, zavolejte metodu IBackgroundCopyJob::Cancel. Metoda Cancel odstraní úlohu z fronty přenosu a dočasné soubory z klienta. Tuto metodu obvykle voláte, pokud nemůžete vyřešit chybu přidruženou k úloze.

Metoda Zrušit zruší nahrávání, pokud nahrávání není dokončené. Pokud je nahrávání dokončeno a úloha je typu BG_JOB_TYPE_UPLOAD_REPLY, metoda zruší odpověď.

Pokud nezavoláte metodu Complete ani metodu IBackgroundCopyJob::Cancel do 90 dnů (výchozí JobInactivityTimeout zásady skupiny), služba tuto úlohu zruší. Pokud služba zruší úlohu, stažené soubory a soubor odpovědi nejsou klientovi k dispozici; Zrušení úlohy nemá vliv na soubory, které byly úspěšně odeslány. Vždy byste měli volat metodu Complete nebo Cancel a neměli byste se spoléhat na zásadu JobInactivityTimeout k vyčištění vašich úloh. Pokud dojde k dosažení limitu zásad MaxJobsPerUser nebo MaxJobsPerMachine, mohou úlohy, které zůstaly ve frontě, bránit uživatelům v vytváření dalších úloh.