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 |
|---|---|
|
Der Name der Datei, die die Antwortdaten enthalten soll, wurde erfolgreich angegeben. |
|
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. |
|
Der Benutzer verfügt nicht über die Berechtigung zum Schreiben in das angegebene Verzeichnis auf dem Client. |
|
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 |