IBackgroundCopyJob2::GetReplyData-Methode (bits1_5.h)

Artikel
02/26/2024

Ruft eine In-Memory-Kopie der Antwortdaten aus der Serveranwendung ab. Rufen Sie diese Methode nur auf, wenn der Typ des Auftrags BG_JOB_TYPE_UPLOAD_REPLY und der Status BG_JOB_STATE_TRANSFERRED ist.

Syntax

HRESULT GetReplyData(
  [in, out] byte   **ppBuffer,
  [out]     UINT64 *pLength
);

Parameter

[in, out] ppBuffer

Puffer, der die Antwortdaten enthält. Die -Methode legt ppBuffer auf NULL fest, wenn die Serveranwendung keine Antwort zurückgegeben hat. Rufen Sie die CoTaskMemFree-Funktion auf, um ppBuffer frei zu geben, wenn Sie fertig sind.

[out] pLength

Größe der Antwortdaten in ppBuffer in Byte.

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.

Rückgabecode	Beschreibung
S_OK	Die Antwortdaten wurden erfolgreich abgerufen.
BG_E_TOO_LARGE	Die Antwortdaten überschreiten die maximale Puffergröße von 1 MB. Der ppBuffer-Parameter ist auf NULL festgelegt, und pSize enthält die Größe der Antwortdaten.
BG_E_INVALID_STATE	Um die Antwortdaten abzurufen, muss der Status des Auftrags BG_JOB_STATE_TRANSFERRED sein.
E_NOTIMPL	Diese Methode wird nicht für Aufträge vom Typ BG_JOB_TYPE_DOWNLOAD oder BG_JOB_TYPE_UPLOAD implementiert.

Hinweise

Mit der GetReplyData-Methode können Sie die Antwortdaten vor oder nach dem Aufruf der IBackgroundCopyJob::Complete-Methode lesen. Um jedoch die Antwortdaten aus der Antwortdatei zu lesen, müssen Sie zuerst die Complete-Methode aufrufen. Die Datei ist für den Client erst verfügbar, wenn Sie die Complete-Methode aufrufen.

Die GetReplyData-Methode gibt BG_E_TOO_LARGE zurück, wenn die Antwortdaten 1 MB überschreiten (pSize enthält die Größe der Antwortdaten). Um die Antwort abzurufen, wenn sie 1 MB überschreitet, rufen Sie die IBackgroundCopyJob2::GetReplyFileName-Methode auf, um den Dateinamen abzurufen. Öffnen Sie dann die Datei, und lesen Sie die Antwortdaten direkt.

Beispiele

Ein Beispiel, das die GetReplyData-Methode verwendet, finden Sie unter Abrufen der Antwort aus einem Upload-Reply Auftrag.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Windows
Kopfzeile	bits1_5.h (Bits.h einschließen)
Bibliothek	Bits.lib
DLL	BitsPrx2.dll
Verteilbare Komponente	BITS 1.5 unter Windows XP

Weitere Informationen

IBackgroundCopyJob2::GetReplyFileName

IBackgroundCopyJob2::SetReplyFileName

Share via