Metodo IBackgroundCopyFile3::GetTemporaryName (bits3_0.h)

  • Articolo

Ottiene il percorso completo del file temporaneo che contiene il contenuto del download.

Sintassi

HRESULT GetTemporaryName(
  [out] LPWSTR *pFilename
);

Parametri

[out] pFilename

Stringa con terminazione Null che contiene il percorso completo del file temporaneo. Chiamare la funzione CoTaskMemFree per liberare ppFileName al termine.

Valore restituito

Il metodo restituisce i valori restituiti seguenti.

Codice restituito Descrizione
S_OK
 Operazione riuscita

Commenti

Le applicazioni possono usare questo metodo per ottenere l'accesso ai dati prima del completamento del processo. Aprire il file per l'accesso in scrittura condiviso (FILE_SHARE_WRITE). Per determinare il numero di byte trasferiti e disponibili per la lettura, chiamare il metodo IBackgroundCopyFile::GetProgress . Si noti che le informazioni sullo stato di avanzamento verranno impostate su zero se il timestamp dell'URL cambia.

Non aprire il file per la lettura fino a quando BITS non inizia il trasferimento del file; in caso contrario, il processo passerà allo stato di errore temporaneo.

Il file temporaneo è disponibile finché l'applicazione non chiama il metodo IBackgroundCopyJob::Complete o IBackgroundCopyJob::Cancel oppure i criteri di gruppo JobInactivityTimeout scadono. È necessario rilasciare l'handle al file temporaneo prima di chiamare il metodo Complete o Cancel .

L'ACL per il file temporaneo è uguale a quello del file finale quando viene chiamato Complete (l'ACL viene ereditato dalla cartella).

Per determinare se BITS ha completato il trasferimento del file, è possibile:

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione bits3_0.h (include Bits.h)
Libreria Bits.lib

Vedi anche

IBackgroundCopyCallback2::FileTransferred

IBackgroundCopyFile3