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
);

Die 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.

Bemerkungen

Rufen Sie zum Angeben eines Antwortdateinamens 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 für den Client nicht verfügbar ist, bis Sie die Complete-Methode aufrufen.

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

Examples

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

Anforderungen

Siehe auch

IBackgroundCopyJob2::GetReplyData

IBackgroundCopyJob2::SetReplyFileName