Metodo IBackgroundCopyJob2::GetReplyFileName (bits1_5.h)

Recupera il nome del file che contiene i dati di risposta dall'applicazione server. Chiamare questo metodo solo se il tipo di processo è BG_JOB_TYPE_UPLOAD_REPLY.

Sintassi

HRESULT GetReplyFileName(
  [out] LPWSTR *pReplyFileName
);

Parametri

[out] pReplyFileName

Stringa con terminazione null contenente il percorso completo del file di risposta. Chiamare la funzione CoTaskMemFree per liberare pReplyFileName al termine.

Valore restituito

Questo metodo restituisce i valori HRESULT seguenti, nonché altri.

Codice restituito	Descrizione
S_OK	È stato recuperato correttamente il nome del file che contiene i dati di risposta.
E_NOTIMPL	Questo metodo non viene implementato per i processi di tipo BG_JOB_TYPE_DOWNLOAD o BG_JOB_TYPE_UPLOAD.

Commenti

Per specificare un nome file di risposta, chiamare il metodo IBackgroundCopyJob2::SetReplyFileName . Se non è stato specificato un nome, il metodo GetReplyFileName restituisce il nome generato da BITS. Se non è stato specificato un nome e viene chiamato questo metodo prima di aggiungere un file al processo, pReplyFileName è impostato su NULL.

È necessario chiamare il metodo IBackgroundCopyJob::Complete prima di aprire e leggere il file di risposta; il file di risposta non è disponibile per il client finché non si chiama il metodo Complete .

Il file è vuoto se l'applicazione server non ha fornito una risposta.

Esempio

Per un esempio che usa il metodo GetReplyFileName , vedere Recupero della risposta da un processo di Upload-Reply.

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

Vedi anche

IBackgroundCopyJob2::GetReplyData

IBackgroundCopyJob2::SetReplyFileName