Fungsi WinHttpGetDefaultProxyConfiguration (winhttp.h)

Artikel
03/13/2024

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

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

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.

Lihat juga

ProxyCfg.exe, Alat Konfigurasi Proksi

Versi WinHTTP

WinHttpSetDefaultProxyConfiguration

Bagikan melalui