Fungsi WinHttpGetDefaultProxyConfiguration (winhttp.h)
Fungsi WinHttpGetDefaultProxyConfiguration mengambil konfigurasi proksi WinHTTP default dari registri.
Sintaks
WINHTTPAPI BOOL WinHttpGetDefaultProxyConfiguration(
[in, out] WINHTTP_PROXY_INFO *pProxyInfo
);
Parameter
[in, out] pProxyInfo
Penunjuk ke variabel jenis WINHTTP_PROXY_INFO yang menerima konfigurasi proksi default.
Mengembalikan nilai
Mengembalikan TRUE jika berhasil atau FALSE sebaliknya. Untuk mengambil pesan kesalahan tertentu, panggil GetLastError. Kode kesalahan yang dikembalikan termasuk yang berikut ini.
Kode Kesalahan | Deskripsi |
---|---|
|
Terjadi kesalah internal. |
|
Tidak tersedia cukup memori untuk menyelesaikan operasi yang diminta. (Kode galat Windows) |
Keterangan
WinHttpGetDefaultProxyConfiguration mengambil konfigurasi proksi yang ditetapkan oleh WinHttpSetDefaultProxyConfiguration atau ProxyCfg.exe.
Konfigurasi proksi default dapat diganti untuk sesi WinHTTP dengan memanggil WinHttpSetOption dan menentukan bendera WINHTTP_OPTION_PROXY .
WinHttpGetDefaultProxyConfiguration tidak mengambil konfigurasi untuk sesi saat ini. Ini mengambil konfigurasi yang ditentukan dalam registri.
Jika registri berisi daftar server proksi, anggota dwAccessTypepProxyInfo diatur ke WINHTTP_ACCESS_TYPE_NAMED_PROXY. Jika tidak, diatur ke WINHTTP_ACCESS_TYPE_NO_PROXY.
WinHttpGetDefaultProxyConfiguration mengalokasikan memori untuk anggota string pProxyInfo. Untuk membebaskan memori ini, panggil GlobalFree.
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 mengambil konfigurasi proksi default dari registri.
WINHTTP_PROXY_INFO proxyInfo;
// Retrieve the default proxy configuration.
WinHttpGetDefaultProxyConfiguration( &proxyInfo );
// Display the proxy servers and free memory
// allocated to this string.
if (proxyInfo.lpszProxy != NULL)
{
printf("Proxy server list: %S\n", proxyInfo.lpszProxy);
GlobalFree( proxyInfo.lpszProxy );
}
// Display the bypass list and free memory
// allocated to this string.
if (proxyInfo.lpszProxyBypass != NULL)
{
printf("Proxy bypass list: %S\n", proxyInfo.lpszProxyBypass);
GlobalFree( 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 di Windows XP dan Windows 2000. |