IBackgroundCopyJob2::GetReplyFileName-Methode (bits1_5.h)

Ruft den Namen der Datei ab, die die Antwortdaten aus der Serveranwendung enthält. Rufen Sie diese Methode nur auf, wenn der Auftragstyp BG_JOB_TYPE_UPLOAD_REPLY ist.

Syntax

HRESULT GetReplyFileName(
  [out] LPWSTR *pReplyFileName
);

Parameter

[out] pReplyFileName

Null-beendete Zeichenfolge, die den vollständigen Pfad zur Antwortdatei enthält. Rufen Sie die CoTaskMemFree-Funktion auf, um pReplyFileName frei zu geben, wenn Sie fertig sind.

Rückgabewert

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

Rückgabecode Beschreibung
S_OK
Der Name der Datei, die die Antwortdaten enthält, wurde erfolgreich abgerufen.
E_NOTIMPL
Diese Methode wird nicht für Aufträge vom Typ BG_JOB_TYPE_DOWNLOAD oder BG_JOB_TYPE_UPLOAD implementiert.

Hinweise

Um einen Antwortdateinamen anzugeben, rufen Sie die IBackgroundCopyJob2::SetReplyFileName-Methode auf. Wenn Sie keinen Namen angegeben haben, gibt die GetReplyFileName-Methode den Namen zurück, den BITS für Sie generiert hat. Wenn Sie keinen Namen angegeben haben und diese Methode aufgerufen haben, bevor Sie dem Auftrag eine Datei hinzufügen, wird pReplyFileName auf NULL festgelegt.

Sie müssen die IBackgroundCopyJob::Complete-Methode aufrufen, bevor Sie die Antwortdatei öffnen und lesen. Die Antwortdatei ist für den Client erst verfügbar, wenn Sie die Complete-Methode aufrufen.

Die Datei ist leer, wenn die Serveranwendung keine Antwort bereitgestellt hat.

Beispiele

Ein Beispiel, das die GetReplyFileName-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::GetReplyData

IBackgroundCopyJob2::SetReplyFileName