Metodo IBackgroundCopyJob2::SetReplyFileName (bits1_5.h)
Specifica il nome del file per contenere i dati di risposta dall'applicazione server. Chiamare questo metodo solo se il tipo del processo è BG_JOB_TYPE_UPLOAD_REPLY.
Sintassi
HRESULT SetReplyFileName(
[in] LPCWSTR ReplyFileName
);
Parametri
[in] ReplyFileName
Stringa con terminazione null contenente il percorso completo del file di risposta. BITS genera il nome del file se ReplyFileNamePathSpec è NULL o una stringa vuota. Non è possibile usare caratteri jolly nel percorso o nel nome file e le directory nel percorso devono esistere. Il percorso è limitato a MAX_PATH, non incluso il terminatore Null. L'utente deve disporre delle autorizzazioni per la scrittura nella directory. BITS non supporta i flussi NTFS. Anziché usare le unità di rete, che sono specifiche della sessione, usare i percorsi UNC, ad esempio \server\share\path\file. Non includere \? prefisso nel percorso.
Valore restituito
Questo metodo restituisce i valori HRESULT seguenti, nonché altri.
| Codice restituito | Descrizione |
|---|---|
|
È stato specificato il nome del file per contenere i dati di risposta. |
|
Non è possibile modificare il nome del file di risposta dopo che BITS inizia a trasferire la risposta al client. BITS trasferisce la risposta al client se lo stato è BG_JOB_STATE_TRANSFERRING e il membro BytesTotaldella struttura BG_JOB_REPLY_PROGRESS non è BG_SIZE_UNKNOWN. |
|
L'utente non dispone dell'autorizzazione per scrivere nella directory specificata nel client. |
|
Il nome del file di risposta non è valido o supera MAX_PATH. |
Commenti
BITS genera il nome del file se non si chiama il metodo SetReplyFileName prima di chiamare il metodo IBackgroundCopyJob::Resume per la prima volta.
Se BITS genera il nome del file, il file di risposta viene scritto nella stessa directory del file di caricamento locale.
È possibile chiamare il metodo SetReplyFileName in qualsiasi momento prima che BITS inizi a scaricare la risposta dall'applicazione server; il metodo ha esito negativo se il download è iniziato.
Il file di risposta è disponibile per il client dopo aver chiamato il metodo IBackgroundCopyJob::Complete . Per recuperare i dati di risposta prima di chiamare il metodo Complete , chiamare il metodo IBackgroundCopyJob2::GetReplyData .
Il file è vuoto se l'applicazione server non ha fornito una risposta.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2003 |
| Piattaforma di destinazione | Windows |
| Intestazione | bits1_5.h (includere Bits.h) |
| Libreria | Bits.lib |
| DLL | BitsPrx2.dll |
| Componente ridistribuibile | BITS 1.5 in Windows XP |