Bagikan melalui


Fungsi WinHttpDetectAutoProxyConfigUrl (winhttp.h)

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