IBackgroundCopyJob2::GetReplyData-Methode (bits1_5.h)
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 |
|---|---|
|
Die Antwortdaten wurden erfolgreich abgerufen. |
|
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. |
|
Um die Antwortdaten abzurufen, muss der Status des Auftrags BG_JOB_STATE_TRANSFERRED sein. |
|
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 |