struktur INTERNET_PER_CONN_OPTIONA (wininet.h)

Artikel
03/08/2023

Berisi nilai opsi.

Sintaks

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPSTR    pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONA, *LPINTERNET_PER_CONN_OPTIONA;

Anggota

dwOption

Opsi untuk dikueri atau diatur. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
INTERNET_PER_CONN_AUTOCONFIG_URL	Mengatur atau mengambil string yang berisi URL ke skrip konfigurasi otomatis.
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	Mengatur atau mengambil pengaturan penemuan otomatis. Anggota Nilai akan berisi satu atau beberapa nilai berikut ini: AUTO_PROXY_FLAG_ALWAYS_DETECT Selalu deteksi pengaturan secara otomatis. AUTO_PROXY_FLAG_CACHE_INIT_RUN Menunjukkan bahwa hasil cache skrip konfigurasi proksi otomatis harus digunakan, alih-alih benar-benar menjalankan skrip, kecuali file yang di-cache telah kedaluwarsa. AUTO_PROXY_FLAG_DETECTION_RUN Deteksi otomatis telah dijalankan setidaknya sekali pada koneksi ini. AUTO_PROXY_FLAG_DETECTION_SUSPECT Saat ini tidak didukung. AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT Jangan izinkan penembolokan hasil skrip konfigurasi proksi otomatis. AUTO_PROXY_FLAG_MIGRATED Pengaturan dimigrasikan dari penginstalan Microsoft Internet Explorer 4.0, dan deteksi otomatis harus dicoba sekali. AUTO_PROXY_FLAG_USER_SET Pengguna telah secara eksplisit mengatur deteksi otomatis.
INTERNET_PER_CONN_FLAGS	Mengatur atau mengambil jenis koneksi. Anggota Nilai akan berisi satu atau beberapa nilai berikut ini: PROXY_TYPE_DIRECT Koneksi tidak menggunakan server proksi. PROXY_TYPE_PROXY Koneksi menggunakan server proksi yang diatur secara eksplisit. PROXY_TYPE_AUTO_PROXY_URL Koneksi mengunduh dan memproses skrip konfigurasi otomatis pada URL tertentu. PROXY_TYPE_AUTO_DETECT Koneksi secara otomatis mendeteksi pengaturan.
INTERNET_PER_CONN_PROXY_BYPASS	Mengatur atau mengambil string yang berisi URL yang tidak menggunakan server proksi.
INTERNET_PER_CONN_PROXY_SERVER	Mengatur atau mengambil string yang berisi server proksi.
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL	URL konfigurasi otomatis berantai. Digunakan saat URL konfigurasi otomatis utama menunjuk ke file INS yang mengatur URL konfigurasi otomatis kedua untuk informasi proksi.
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	menit hingga refresh otomatis URL konfigurasi otomatis dengan autodiscovery.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	Opsi baca saja. Mengembalikan waktu URL konfigurasi otomatis baik terakhir yang diketahui ditemukan menggunakan autodiscovery.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	Opsi baca saja. Mengembalikan URL baik terakhir yang diketahui yang ditemukan menggunakan autodiscovery.

Windows 7 dan yang lebih baru:

Klien yang mendukung Internet Explorer 8 harus mengkueri jenis koneksi menggunakan INTERNET_PER_CONN_FLAGS_UI. Jika kueri ini gagal, maka sistem menjalankan versi Internet Explorer sebelumnya dan klien harus mengkueri lagi dengan INTERNET_PER_CONN_FLAGS.

Pulihkan tipe koneksi menggunakan INTERNET_PER_CONN_FLAGS terlepas dari versi Internet Explorer.

Nilai	Makna
INTERNET_PER_CONN_FLAGS_UI	Mengatur atau mengambil jenis koneksi. Anggota Nilai akan berisi satu atau beberapa nilai berikut ini: PROXY_TYPE_DIRECT Koneksi tidak menggunakan server proksi. PROXY_TYPE_PROXY Koneksi menggunakan server proksi yang diatur secara eksplisit. PROXY_TYPE_AUTO_PROXY_URL Koneksi mengunduh dan memproses skrip konfigurasi otomatis pada URL tertentu. PROXY_TYPE_AUTO_DETECT Koneksi secara otomatis mendeteksi pengaturan.

Nilai

Makna

INTERNET_PER_CONN_FLAGS_UI

Mengatur atau mengambil jenis koneksi. Anggota Nilai akan berisi satu atau beberapa nilai berikut ini:

PROXY_TYPE_DIRECT: Koneksi tidak menggunakan server proksi.
PROXY_TYPE_PROXY: Koneksi menggunakan server proksi yang diatur secara eksplisit.
PROXY_TYPE_AUTO_PROXY_URL: Koneksi mengunduh dan memproses skrip konfigurasi otomatis pada URL tertentu.
PROXY_TYPE_AUTO_DETECT: Koneksi secara otomatis mendeteksi pengaturan.

Value

Union yang berisi nilai untuk opsi . Ini bisa menjadi salah satu jenis berikut tergantung pada nilai dwOption:

dwValue

Nilai bilangan bulat panjang yang tidak ditandatangani.

pszValue

Penunjuk ke nilai string.

ftValue

Struktur FILETIME .

Value.dwValue

Value.pszValue

Value.ftValue

Keterangan

Di Internet Explorer 5, hanya versi ANSI internetQueryOption dan InternetSetOption yang akan berfungsi dengan struktur INTERNET_PER_CONN_OPTION . Versi Unicode akan mendukung struktur INTERNET_PER_CONN_OPTION di versi Internet Explorer yang lebih baru.

Untuk kueri yang mengembalikan string, InternetQueryOption mengalokasikan memori untuk anggota struktur pszValue . Aplikasi panggilan harus membebaskan memori ini menggunakan fungsi GlobalFree ketika telah selesai menggunakan string.

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).

Catatan

Header wininet.h mendefinisikan INTERNET_PER_CONN_OPTION sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	wininet.h

Lihat juga

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption

Bagikan melalui