IBackgroundCopyFile2::SetRemoteName-Methode

Ändert den Remotenamen in eine neue URL in einem Downloadauftrag.

Syntax

HRESULT SetRemoteName(
  [in] LPCWSTR RemoteName
);

Parameter

RemoteName [in]

Null-beendete Zeichenfolge, die den Namen der Datei auf dem Server enthält. Informationen zum Angeben des Remotenamens finden Sie im RemoteName-Element .

Rückgabewert

Diese Methode gibt neben anderen auch die folgenden Rückgabewerte zurück.

Bemerkungen

In der Regel rufen Sie diese Methode auf, wenn Sie die URL ändern möchten, die zum Übertragen der Datei verwendet wird, oder wenn Sie den Dateinamen oder Pfad ändern möchten.

Diese Methode serialisiert nicht, wenn sie zurückgibt. Um die Änderung zu serialisieren, setzen Sie den Auftrag an, rufen Sie diese Methode auf (wenn Sie mehrere Dateien im Auftrag ändern, verwenden Sie eine Schleife), und setzen Sie den Auftrag fort. Durch Aufrufen der IBackgroundCopyJob::Resume-Methode wird die Änderung serialisiert.

Wenn sich der Zeitstempel oder die Dateigröße des neuen Remotenamens vom vorherigen Remotenamen unterscheidet oder der neue Server keine Prüfpunkt-Fortsetzung unterstützt (für HTTP-Remotenamen), startet die Übermittlungsoptimierung den Download neu. Andernfalls wird die Übertragung von derselben Position auf dem neuen Server fortgesetzt. Die Übermittlungsoptimierung startet bereits übertragene Dateien nicht neu.

Anforderungen

Siehe auch

IBackgroundCopyFile2