IBackgroundCopyJob2::SetReplyFileName-Methode (bits1_5.h)

Gibt den Namen der Datei an, die die Antwortdaten der Serveranwendung enthalten soll. Rufen Sie diese Methode nur auf, wenn der Typ des Auftrags BG_JOB_TYPE_UPLOAD_REPLY ist.

Syntax

HRESULT SetReplyFileName(
  [in] LPCWSTR ReplyFileName
);

Parameter

[in] ReplyFileName

Null-beendete Zeichenfolge, die den vollständigen Pfad zur Antwortdatei enthält. BITS generiert den Dateinamen, wenn ReplyFileNamePathSpecNULL oder eine leere Zeichenfolge ist. Sie können keine Wildcards im Pfad oder Dateinamen verwenden, und Verzeichnisse im Pfad müssen vorhanden sein. Der Pfad ist auf MAX_PATH beschränkt, wobei der NULL-Abschlusszeichen nicht enthalten ist. Der Benutzer muss über Berechtigungen zum Schreiben in das Verzeichnis verfügen. BITS unterstützt keine NTFS-Streams. Verwenden Sie anstelle von sitzungsspezifischen Netzwerklaufwerken UNC-Pfade (z. B. \server\share\path\file). Schließen Sie die \? nicht ein. Präfix im Pfad.

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 enthalten soll, wurde erfolgreich angegeben.
BG_E_INVALID_STATE
Sie können den Namen der Antwortdatei nicht ändern, nachdem BITS mit der Übertragung der Antwort an den Client begonnen hat. BITS überträgt die Antwort an den Client, wenn der Zustand BG_JOB_STATE_TRANSFERRING ist und der BytesTotal-Member der BG_JOB_REPLY_PROGRESS-Struktur nicht BG_SIZE_UNKNOWN ist.
E_ACCESSDENIED
Der Benutzer verfügt nicht über die Berechtigung zum Schreiben in das angegebene Verzeichnis auf dem Client.
E_INVALIDARG
Der Name der Antwortdatei ist ungültig oder überschreitet MAX_PATH.

Hinweise

BITS generiert den Dateinamen, wenn Sie die SetReplyFileName-Methode nicht aufrufen, bevor Sie die IBackgroundCopyJob::Resume-Methode zum ersten Mal aufrufen.

Wenn BITS den Dateinamen generiert, wird die Antwortdatei in dasselbe Verzeichnis wie die lokale Uploaddatei geschrieben.

Sie können die SetReplyFileName-Methode jederzeit aufrufen, bevor BITS mit dem Herunterladen der Antwort von der Serveranwendung beginnt. Die Methode schlägt fehl, wenn der Download begonnen hat.

Die Antwortdatei steht dem Client nach dem Aufruf der IBackgroundCopyJob::Complete-Methode zur Verfügung. Um die Antwortdaten vor dem Aufrufen der Complete-Methode abzurufen, rufen Sie die IBackgroundCopyJob2::GetReplyData-Methode auf.

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

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

IBackgroundCopyJob::GetReplyData

IBackgroundCopyJob::GetReplyFileName