Fungsi WinHttpSetDefaultProxyConfiguration (winhttp.h)

Artikel
03/09/2024

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
ERROR_WINHTTP_INTERNAL_ERROR	Terjadi kesalah internal.
ERROR_NOT_ENOUGH_MEMORY	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.

Catatan Untuk Windows XP dan Windows 2000, lihat bagian Persyaratan Run-Time di halaman mulai WinHTTP.

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

Versi WinHTTP

WinHttpGetDefaultProxyConfiguration

Bagikan melalui