Fungsi InternetSetOptionA (wininet.h)

Artikel
03/08/2023

Mengatur opsi Internet.

Sintaks

BOOL InternetSetOptionA(
  [in] HINTERNET hInternet,
  [in] DWORD     dwOption,
  [in] LPVOID    lpBuffer,
  [in] DWORD     dwBufferLength
);

Parameter

[in] hInternet

Tangani untuk mengatur informasi.

[in] dwOption

Opsi Internet yang akan diatur. Ini bisa menjadi salah satu nilai Bendera Opsi .

[in] lpBuffer

Penunjuk ke buffer yang berisi pengaturan opsi.

[in] dwBufferLength

Ukuran buffer lpBuffer . Jika lpBuffer berisi string, ukurannya dalam TCHAR. Jika lpBuffer berisi apa pun selain string, ukurannya dalam byte.

Nilai kembali

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk mendapatkan pesan kesalahan tertentu, panggil GetLastError.

Keterangan

GetLastError akan mengembalikan kesalahan ERROR_INVALID_PARAMETER jika bendera opsi yang tidak dapat diatur ditentukan.

Untuk informasi selengkapnya, lihat Mengatur dan Mengambil Opsi Internet.

Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.

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 InternetSetOption 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


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll