Metode IBackgroundCopyJob::SetProxySettings (bits.h)

  • Artikel

Menentukan proksi mana yang akan digunakan untuk mentransfer file.

Sintaks

HRESULT SetProxySettings(
  [in] BG_JOB_PROXY_USAGE ProxyUsage,
  [in] const WCHAR        *ProxyList,
  [in] const WCHAR        *ProxyBypassList
);

Parameter

[in] ProxyUsage

Menentukan apakah akan menggunakan pengaturan proksi pengguna, tidak menggunakan proksi, atau menggunakan pengaturan proksi yang ditentukan aplikasi. Defaultnya adalah menggunakan pengaturan proksi pengguna, BG_JOB_PROXY_USAGE_PRECONFIG. Untuk daftar opsi proksi, lihat enumerasi BG_JOB_PROXY_USAGE .

[in] ProxyList

String yang dihentikan null yang berisi proksi yang digunakan untuk mentransfer file. Daftar dibatasi spasi. Untuk detail tentang menentukan proksi, lihat Keterangan.

Parameter ini harus NULL jika nilai ProxyUsageBG_JOB_PROXY_USAGE_PRECONFIG, BG_JOB_PROXY_USAGE_NO_PROXY, atau BG_JOB_PROXY_USAGE_AUTODETECT.

Panjang daftar proksi dibatasi hingga 4.000 karakter, tidak termasuk terminator null.

[in] ProxyBypassList

String yang dihentikan dengan null yang berisi daftar opsional nama host, alamat IP, atau keduanya, yang dapat melewati proksi. Daftar dibatasi spasi. Untuk detail tentang menentukan proksi bypass, lihat Keterangan.

Parameter ini harus NULL jika nilai ProxyUsageBG_JOB_PROXY_USAGE_PRECONFIG, BG_JOB_PROXY_USAGE_NO_PROXY, atau BG_JOB_PROXY_USAGE_AUTODETECT.

Panjang daftar bypass proksi dibatasi hingga 4.000 karakter, tidak termasuk terminator null.

Nilai kembali

Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.

Menampilkan kode Deskripsi
S_OK
 Proksi berhasil ditentukan.
E_NOTIMPL
 Nilai untuk ProxyUsage tidak ditentukan dalam enumerasi BG_JOB_PROXY_USAGE .
BG_E_PROXY_LIST_TOO_LARGE
 Buffer pProxyList tidak boleh melebihi 32 KB.
BG_E_PROXY_BYPASS_LIST_TOO_LARGE
 pProxyBypassList tidak boleh melebihi 32 KB.
BG_E_INVALID_STATE
 Status pekerjaan tidak dapat BG_JOB_STATE_CANCELLED atau BG_JOB_STATE_ACKNOWLEDGED.
E_INVALIDARG
 Parameter pProxyList tidak boleh NULL jika ProxyUsageBG_JOB_PROXY_USAGE_OVERRIDE.

Keterangan

Informasi proksi yang Anda berikan divalidasi pada durasi. Jika informasi proksi tidak valid, pekerjaan memasuki status BG_JOB_STATE_ERROR dengan kode kesalahan BG_E_INVALID_PROXY_INFO .

Jika layanan Anda berjalan sebagai LocalSystem, Anda harus menggunakan metode SetProxySettings untuk secara eksplisit menentukan daftar bypass proksi atau proksi untuk akun dan mengatur ProxyUsage ke BG_JOB_PROXY_USAGE_OVERRIDE. Untuk informasi selengkapnya tentang menggunakan akun sistem dengan BITS, lihat Akun Layanan dan BITS.

BITS tidak mengenali pengaturan proksi yang diatur menggunakan file Proxycfg.exe.

Tentukan proksi sebagai:

"[protocol=][protocol"://"]server[":"port]"

Protokol yang valid adalah HTTP dan HTTPS. Daftar proksi dapat berisi nomor port yang digunakan untuk mengakses proksi. Misalnya, untuk mencantumkan proksi HTTP, string yang valid adalah "http=http://http_proxy_name:80", di mana http_proxy_name adalah nama server proksi dan 80 adalah nomor port yang harus Anda gunakan untuk mengakses proksi. Jika proksi menggunakan nomor port default untuk protokol tersebut, maka Anda dapat menghilangkan nomor port. Jika nama proksi dicantumkan dengan sendirinya, Anda dapat menggunakannya sebagai proksi default untuk protokol apa pun yang tidak memiliki proksi tertentu. Misalnya, "http=http://http_proxyother_proxy" menggunakan http_proxy untuk operasi HTTP apa pun, sementara protokol HTTPS menggunakan proksi bernama other_proxy.

Anda dapat mencantumkan nama host yang dikenal secara lokal atau alamat Protokol Internet (IP) dalam daftar bypass proksi. Nama ini dapat berisi kartubebas, seperti "", yang menyebabkan aplikasi melewati server proksi untuk alamat yang sesuai dengan pola yang ditentukan, misalnya, ".microsoft.com" atau ".org". Karakter kartubebas harus menjadi karakter paling kiri dalam namanya. Misalnya, "aaa." tidak didukung. Anda dapat menentukan <makro lokal> untuk menunjukkan bahwa semua situs intranet lokal dilewati. Situs intranet lokal dianggap sebagai semua server yang tidak berisi titik dalam namanya.

BITS menggunakan pengaturan proksi Internet Explorer pengguna jika aplikasi tidak menentukan penggunaan proksi. Perilaku default ini biasanya berfungsi jika aplikasi mengirimkan pekerjaan dalam konteks pengguna interaktif tetapi mungkin tidak berfungsi jika layanan yang berjalan sebagai LocalSystem mengirimkan pekerjaan. Anda dapat menentukan pengaturan proksi Internet Explorer untuk LocalSystem; namun, sulit untuk mendeteksi pengaturan ini ketika masalah terjadi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP
Server minimum yang didukung Windows Server 2003
Target Platform Windows
Header bits.h
Pustaka Bits.lib
DLL QmgrPrxy.dll

Lihat juga

BG_JOB_PROXY_USAGE

IBackgroundCopyJob::GetProxySettings