Fungsi InternetQueryOptionW (wininet.h)

Artikel
03/04/2024

Mengkueri opsi Internet pada handel yang ditentukan.

Sintaks

BOOL InternetQueryOptionW(
  [in]      HINTERNET hInternet,
  [in]      DWORD     dwOption,
  [out]     LPVOID    lpBuffer,
  [in, out] LPDWORD   lpdwBufferLength
);

Parameter

[in] hInternet

Menangani informasi kueri yang akan dikueri.

[in] dwOption

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

[out] lpBuffer

Penunjuk ke buffer yang menerima pengaturan opsi. String yang dikembalikan oleh InternetQueryOption dialokasikan secara global, sehingga aplikasi panggilan harus membebaskannya ketika selesai menggunakannya.

[in, out] lpdwBufferLength

Penunjuk ke variabel yang berisi ukuran lpBuffer, dalam byte. Saat InternetQueryOption kembali, lpdwBufferLength menentukan ukuran data yang ditempatkan ke dalam lpBuffer. Jika GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER, parameter ini menunjuk ke jumlah byte yang diperlukan untuk menyimpan informasi yang diminta.

Nilai kembali

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

Keterangan

GetLastError akan mengembalikan ERROR_INVALID_PARAMETER jika bendera opsi yang tidak valid untuk jenis handel yang ditentukan diteruskan ke parameter dwOption .

Untuk mengetahui 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 InternetQueryOption sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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]
Target Platform	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll