Fungsi WinHttpGetIEProxyConfigForCurrentUser (winhttp.h)

Artikel
03/15/2023

Fungsi WinHttpGetIEProxyConfigForCurrentUser mengambil konfigurasi proksi Internet Explorer untuk pengguna saat ini.

Sintaks

WINHTTPAPI BOOL WinHttpGetIEProxyConfigForCurrentUser(
  [in, out] WINHTTP_CURRENT_USER_IE_PROXY_CONFIG *pProxyConfig
);

Parameter

[in, out] pProxyConfig

Penunjuk, pada input, ke struktur WINHTTP_CURRENT_USER_IE_PROXY_CONFIG . Pada output, struktur berisi pengaturan proksi Internet Explorer untuk sambungan jaringan aktif saat ini (misalnya, LAN, dial-up, atau koneksi VPN).

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_FILE_NOT_FOUND	Tidak ada pengaturan proksi Internet Explorer yang dapat ditemukan.
ERROR_WINHTTP_INTERNAL_ERROR	Terjadi kesalah internal.
ERROR_NOT_ENOUGH_MEMORY	Tidak tersedia cukup memori untuk menyelesaikan operasi yang diminta. (Kode galat Windows)

Keterangan

Di Internet Explorer, pengaturan proksi ditemukan pada tab Koneksi dari opsi menuOpsi InternetAlat / . Pengaturan proksi dikonfigurasi berdasarkan per koneksi; artinya, pengaturan proksi untuk koneksi LAN terpisah dari pengaturan untuk sambungan dial-up atau VPN. WinHttpGetIEProxyConfigForCurrentUser mengembalikan pengaturan proksi untuk koneksi aktif saat ini.

Fungsi ini berguna dalam aplikasi klien yang berjalan di lingkungan jaringan tempat protokol Web Proxy Auto-Discovery (WPAD) tidak diimplementasikan (artinya tidak ada file Konfigurasi Otomatis Proksi yang tersedia). Jika file PAC tidak tersedia, maka fungsi WinHttpGetProxyForUrl gagal. Fungsi WinHttpGetIEProxyConfigForCurrentUser dapat digunakan sebagai mekanisme fall-back untuk menemukan konfigurasi proksi yang dapat dikerjakan dengan mengambil konfigurasi proksi pengguna di Internet Explorer.

Fungsi ini tidak boleh digunakan dalam proses layanan yang tidak meniru pengguna yang masuk. Jika penelepon tidak meniru pengguna yang masuk, WinHTTP mencoba mengambil pengaturan Internet Explorer untuk proses layanan saat ini: misalnya, layanan lokal atau layanan jaringan. Jika pengaturan Internet Explorer tidak dikonfigurasi untuk akun sistem ini, panggilan ke WinHttpGetIEProxyConfigForCurrentUser akan gagal.

Pemanggil harus membebaskan string lpszProxy, lpszProxyBypass , dan lpszAutoConfigUrl dalam struktur WINHTTP_CURRENT_USER_IE_PROXY_CONFIG jika bukan NULL. Gunakan GlobalFree untuk membebaskan string.

Persyaratan


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

Lihat juga

Versi WinHTTP

Share via