Fungsi WinHttpSetDefaultProxyConfiguration (winhttp.h)
Penting
Penggunaan WinHttpSetDefaultProxyConfiguration tidak digunakan lagi di Windows 8.1 dan yang lebih baru. Sebagian besar konfigurasi proksi tidak didukung oleh WinHttpSetDefaultProxyConfiguration, juga tidak mendukung autentikasi proksi. Sebagai gantinya, gunakan WINHTTP_ACCESS_TYPE_AUTOMATIC_PROXY dengan WinHttpOpen.
Fungsi WinHttpSetDefaultProxyConfiguration mengatur konfigurasi proksi WinHTTP default di registri.
Sintaks
WINHTTPAPI BOOL WinHttpSetDefaultProxyConfiguration(
[in] WINHTTP_PROXY_INFO *pProxyInfo
);
Parameter
[in] pProxyInfo
Penunjuk ke variabel jenis WINHTTP_PROXY_INFO yang menentukan konfigurasi proksi default.
Mengembalikan nilai
Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Di antara kode kesalahan yang dikembalikan adalah sebagai berikut.
Kode Kesalahan | Deskripsi |
---|---|
|
Terjadi kesalah internal. |
|
Memori tidak cukup tersedia untuk menyelesaikan operasi yang diminta. (Kode galat Windows) |
Keterangan
Konfigurasi proksi default yang diatur oleh WinHttpSetDefaultProxyConfiguration dapat ditimpa untuk sesi WinHTTP yang ada dengan memanggil WinHttpSetOption dan menentukan bendera WINHTTP_OPTION_PROXY . Konfigurasi proksi default dapat diganti untuk sesi baru dengan menentukan konfigurasi dengan fungsi WinHttpOpen .
Anggota dwAccessType dari struktur WINHTTP_PROXY_INFO yang diarahkan oleh pProxyInfo harus diatur ke WINHTTP_ACCESS_TYPE_NAMED_PROXY jika proksi ditentukan. Jika tidak, itu harus diatur ke WINHTTP_ACCESS_TYPE_DEFAULT_PROXY.
Setiap sesi baru yang dibuat setelah memanggil fungsi ini menggunakan konfigurasi proksi default baru.
Bahkan ketika WinHTTP digunakan dalam mode asinkron (yaitu, ketika WINHTTP_FLAG_ASYNC telah diatur di WinHttpOpen), fungsi ini beroperasi secara sinkron. Nilai yang dikembalikan menunjukkan keberhasilan atau kegagalan. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Contoh
Contoh kode berikut menunjukkan cara mengatur konfigurasi proksi default di registri.
WINHTTP_PROXY_INFO proxyInfo;
// Allocate memory for string members.
proxyInfo.lpszProxy = new WCHAR[25];
proxyInfo.lpszProxyBypass = new WCHAR[25];
// Set the members of the proxy info structure.
proxyInfo.dwAccessType = WINHTTP_ACCESS_TYPE_NAMED_PROXY;
swprintf_s(proxyInfo.lpszProxy, 25, L"proxy_server");
swprintf_s(proxyInfo.lpszProxyBypass, 25, L"<local>");
// Set the default proxy configuration.
if (WinHttpSetDefaultProxyConfiguration( &proxyInfo ))
printf("Proxy Configuration Set.\n");
// Free memory allocated to the strings.
delete [] proxyInfo.lpszProxy;
delete [] proxyInfo.lpszProxyBypass;
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP, Windows 2000 Professional dengan SP3 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003, Windows 2000 Server dengan SP3 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winhttp.h |
Pustaka | Winhttp.lib |
DLL | Winhttp.dll |
Redistribusi | WinHTTP 5.0 dan Internet Explorer 5.01 atau yang lebih baru pada Windows XP dan Windows 2000. |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk