Metode IBackgroundCopyFile2::SetRemoteName

Mengubah nama jarak jauh menjadi URL baru dalam pekerjaan pengunduhan.

Sintaks

HRESULT SetRemoteName(
  [in] LPCWSTR RemoteName
);

Parameter

RemoteName [in]

String yang dihentikan null yang berisi nama file di server. Untuk informasi tentang menentukan nama jarak jauh, lihat anggota RemoteName .

Nilai kembali

Metode ini mengembalikan nilai pengembalian berikut, serta nilai lainnya.

Menampilkan kode	Deskripsi
S_OK	Berhasil
E_INVALIDARG	Nama jarak jauh baru adalah URL yang tidak valid atau URL baru terlalu panjang (URL tidak boleh melebihi 2.200 karakter).

Keterangan

Biasanya, Anda memanggil metode ini jika Anda ingin mengubah URL yang digunakan untuk mentransfer file atau jika Anda ingin mengubah nama atau jalur file.

Metode ini tidak diserialisasikan ketika kembali. Untuk menserialisasikan perubahan, tangguhkan pekerjaan, panggil metode ini (jika mengubah beberapa file dalam pekerjaan, gunakan perulangan), dan lanjutkan pekerjaan. Memanggil metode IBackgroundCopyJob::Resume menserialisasikan perubahan.

Jika stempel waktu atau ukuran file nama jarak jauh baru berbeda dari nama jarak jauh sebelumnya atau server baru tidak mendukung resume titik pemeriksaan (untuk nama jarak jauh HTTP), Pengoptimalan Pengiriman memulai ulang unduhan. Jika tidak, transfer dilanjutkan dari posisi yang sama di server baru. Pengoptimalan Pengiriman tidak memulai ulang file yang sudah ditransfer.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server, versi 1709 [hanya aplikasi desktop]
Header	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Pustaka	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyFile2 didefinisikan sebagai 83e81b93-0873-474d-8a8c-f2018b1a939c

Lihat juga

IBackgroundCopyFile2