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 |
|---|---|
|
Der Name der Datei, die die Antwortdaten enthält, wurde erfolgreich abgerufen. |
|
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 |