Fungsi WinHttpDetectAutoProxyConfigUrl (winhttp.h)

Artikel
08/27/2023

Fungsi WinHttpDetectAutoProxyConfigUrl menemukan URL untuk file Konfigurasi Otomatis Proksi (PAC). Fungsi ini melaporkan URL file PAC, tetapi tidak mengunduh file.

Sintaks

WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
  [in]  DWORD  dwAutoDetectFlags,
  [out] LPWSTR *ppwstrAutoConfigUrl
);

Parameter

[in] dwAutoDetectFlags

Jenis data yang menentukan protokol apa yang akan digunakan untuk menemukan file PAC. Jika bendera deteksi otomatis DHCP dan DNS diatur, DHCP digunakan terlebih dahulu; jika tidak ada URL PAC yang ditemukan menggunakan DHCP, maka DNS digunakan.

Nilai	Makna
WINHTTP_AUTO_DETECT_TYPE_DHCP	Gunakan DHCP untuk menemukan file konfigurasi otomatis proksi.
WINHTTP_AUTO_DETECT_TYPE_DNS_A	Gunakan DNS untuk mencoba menemukan file konfigurasi otomatis proksi di lokasi terkenal di domain komputer lokal.

[out] ppwstrAutoConfigUrl

Jenis data yang mengembalikan penunjuk ke string Unicode yang dihentikan null yang berisi URL konfigurasi yang menerima data proksi. Anda harus membebaskan string yang ditunjukkan oleh ppwszAutoConfigUrl menggunakan fungsi GlobalFree .

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_AUTODETECTION_FAILED	Dikembalikan jika WinHTTP tidak dapat menemukan URL file Konfigurasi Otomatis Proksi (PAC).
ERROR_WINHTTP_INTERNAL_ERROR	Terjadi kesalah internal.
ERROR_NOT_ENOUGH_MEMORY	Tidak tersedia cukup memori untuk menyelesaikan operasi yang diminta. (Kode galat Windows)

Keterangan

WinHTTP menerapkan protokol Penemuan Otomatis Proksi Web (WPAD), sering disebut sebagai proksi otomatis. Untuk informasi selengkapnya tentang lokasi terkenal, lihat bagian Proses Penemuan dari dokumen protokol WPAD.

Perhatikan bahwa karena fungsi WinHttpDetectAutoProxyConfigUrl membutuhkan waktu untuk menyelesaikan operasinya, fungsi tersebut tidak boleh dipanggil dari utas UI.

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

Bagikan melalui