Metodo IBackgroundCopyJob2::GetReplyData (bits1_5.h)

Articolo
02/23/2024

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
S_OK	Sono stati recuperati correttamente i dati di risposta.
BG_E_TOO_LARGE	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.
BG_E_INVALID_STATE	Per recuperare i dati di risposta, lo stato del processo deve essere BG_JOB_STATE_TRANSFERRED.
E_NOTIMPL	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

Vedi anche

IBackgroundCopyJob2::GetReplyFileName

IBackgroundCopyJob2::SetReplyFileName

Condividi tramite