Metodo IBackgroundCopyJob::Complete
Termina il processo e salva i file trasferiti nel client.
Sintassi
HRESULT Complete();
Parametri
Questo metodo non presenta parametri.
Valore restituito
Questo metodo restituisce i valori HRESULT seguenti. Il metodo può anche restituire errori correlati alla ridenominazione delle copie temporanee dei file trasferiti ai nomi specificati.
| Codice restituito | Descrizione |
|---|---|
|
Tutti i file trasferiti correttamente. |
|
Per i download, lo stato del processo non può essere BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED. Per i caricamenti, lo stato del processo deve essere BG_JOB_STATE_TRANSFERRED. |
Commenti
Tutti i file sono stati trasferiti correttamente se lo stato del processo è BG_JOB_STATE_TRANSFERRED. Per controllare lo stato del processo, chiamare il metodo IBackgroundCopyJob::GetState . È anche possibile implementare l'interfaccia IBackgroundCopyCallback per ricevere una notifica quando tutti i file sono stati trasferiti al client.
Ottimizzazione recapito mantiene i processi che sono inferiori a 30 giorni. Tutti i processi meno recenti verranno rimossi. Ottimizzazione recapito non supporta l'Criteri di gruppo JobInactivityTimeout.
Per i processi di download, è possibile chiamare il metodo Complete in qualsiasi momento durante il processo di trasferimento; tuttavia, solo i file trasferiti correttamente al client prima di chiamare questo metodo vengono salvati. Ad esempio, se si chiama il metodo Complete mentre Ottimizzazione recapito elabora il terzo di cinque file, vengono salvati solo i primi due file. Per determinare quali file sono stati trasferiti, chiamare il metodo IBackgroundCopyFile::GetProgress e confrontare il membro BytesTransferred al membro BytesTotal della struttura BG_FILE_PROGRESS .
Per i processi di caricamento, è possibile chiamare il metodo Complete solo quando lo stato del processo è BG_JOB_STATE_TRANSFERRED.
Il proprietario del file è l'utente che ha effettuato la chiamata. Ad esempio, se un amministratore completa il processo di un altro utente, l'amministratore non il proprietario del processo possiede il file.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 10 versione 1709 [solo app desktop] |
| Server minimo supportato |
Windows Server, versione 1709 [solo app desktop] |
| Intestazione |
|
| IDL |
|
| Libreria |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob viene definito come 37668D37-507E-4160-9316-26306D150B12 |