Metodo IBackgroundCopyJob2::GetReplyData (bits1_5.h)
Recupera una copia in memoria dei dati di risposta dall'applicazione server. Chiamare questo metodo solo se il tipo del processo è BG_JOB_TYPE_UPLOAD_REPLY e il relativo stato è BG_JOB_STATE_TRANSFERRED.
Sintassi
HRESULT GetReplyData(
[in, out] byte **ppBuffer,
[out] UINT64 *pLength
);
Parametri
[in, out] ppBuffer
Buffer per contenere i dati di risposta. Il metodo imposta ppBuffer su NULL se l'applicazione server non ha restituito una risposta. Chiamare la funzione CoTaskMemFree per liberare ppBuffer al termine.
[out] pLength
Dimensioni, in byte, dei dati di risposta in ppBuffer.
Valore restituito
Questo metodo restituisce i valori HRESULT seguenti, nonché altri.
Codice restituito | Descrizione |
---|---|
|
Sono stati recuperati correttamente i dati di risposta. |
|
I dati di risposta superano le dimensioni massime del buffer di 1 MB. Il parametro ppBuffer è impostato su NULL e pSize contiene le dimensioni dei dati di risposta. |
|
Per recuperare i dati di risposta, lo stato del processo deve essere BG_JOB_STATE_TRANSFERRED. |
|
Questo metodo non viene implementato per i processi di tipo BG_JOB_TYPE_DOWNLOAD o BG_JOB_TYPE_UPLOAD. |
Commenti
Il metodo GetReplyData consente di leggere i dati di risposta prima o dopo aver chiamato il metodo IBackgroundCopyJob::Complete . Tuttavia, per leggere i dati di risposta dal file di risposta, è prima necessario chiamare il metodo Complete ; il file non è disponibile per il client fino a quando non si chiama il metodo Complete .
Il metodo GetReplyData restituisceBG_E_TOO_LARGE se i dati di risposta superano 1 MB (pSize contiene le dimensioni dei dati di risposta). Per recuperare la risposta se supera 1 MB, chiamare il metodo IBackgroundCopyJob2::GetReplyFileName per recuperare il nome del file. Aprire quindi il file e leggere direttamente i dati di risposta.
Esempio
Per un esempio che usa il metodo GetReplyData , 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 (include Bits.h) |
Libreria | Bits.lib |
DLL | BitsPrx2.dll |
Componente ridistribuibile | BITS 1.5 in Windows XP |