Objek WinHttpRequest

Artikel
06/13/2023

Topik ini menyediakan informasi tentang menggunakan objek WinHTTP WinHttpRequest COM dengan bahasa skrip. Untuk informasi selengkapnya, termasuk C++ API (WinHTTP) silakan lihat Tentang WinHTTP. Lihat Memilih Antarmuka WinHTTP untuk perbandingan antarmuka ini.

Contoh

// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");

 IWinHttpRequest *  pIWinHttpRequest = NULL;
 \\..
    hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);

    if (SUCCEEDED(hr))
    {
        hr = CoCreateInstance(clsid, NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IWinHttpRequest,
                              (void **)&pIWinHttpRequest);
    }

Contoh kode yang diambil dari properti IWinHttpRequest::Status.

Anggota

Objek WinHttpRequest memiliki tipe anggota ini:

Peristiwa
Metode
Properti

Acara

Objek WinHttpRequest memiliki peristiwa ini.

Kejadian	Deskripsi
OnError	Terjadi ketika ada kesalahan run-time dalam aplikasi.
OnResponseDataAvailable	Terjadi ketika data tersedia dari respons.
OnResponseFinished	Terjadi ketika data respons selesai.
OnResponseStart	Terjadi ketika data respons mulai diterima.

Metode

Objek WinHttpRequest memiliki metode ini.

Metode	Deskripsi
Batalkan	Membatalkan metode Kirim WinHTTP .
GetAllResponseHeaders	Mengambil semua header respons HTTP.
GetResponseHeader	Mengambil header respons HTTP.
Open	Membuka koneksi HTTP ke sumber daya HTTP.
Kirim	Mengirim permintaan HTTP ke server HTTP.
SetAutoLogonPolicy	Menyetel Kebijakan Masuk Otomatis saat ini.
SetClientCertificate	Memilih sertifikat klien untuk dikirim ke server Secure Hypertext Transfer Protocol (HTTPS).
SetCredentials	Mengatur kredensial yang akan digunakan dengan server HTTP baik asal atau server proksi.
SetProxy	Mengatur informasi server proksi.
SetRequestHeader	Menambahkan, mengubah, atau menghapus header permintaan HTTP.
SetTimeouts	Menentukan, dalam milidetik, komponen waktu habis individual dari operasi kirim/terima.
WaitForResponse	Menentukan waktu tunggu, dalam detik, agar metode Kirim asinkron selesai, dengan nilai waktu habis opsional.

Properti

Objek WinHttpRequest memiliki properti ini.

Properti	Jenis akses	Deskripsi
Opsi	Baca/Tulis	Mengatur atau mengambil nilai opsi WinHTTP.
ResponseBody	Baca-saja	Mengambil badan entitas respons sebagai array byte yang tidak ditandatangani.
ResponseStream	Baca-saja	Mengambil badan entitas respons sebagai IStream.
Teks Respons	Baca-saja	Mengambil isi entitas respons sebagai teks.
Status	Baca-saja	Mengambil kode status HTTP dari respons terakhir.
Teks Status	Baca-saja	Mengambil teks status HTTP.

Keterangan

Objek WinHttpRequest menggunakan antarmuka IErrorInfo untuk menyediakan data kesalahan. Deskripsi dan nilai kesalahan numerik dapat diperoleh dengan objek Err di Microsoft Visual Basic Scripting Edition (VBScript), dan objek Kesalahan di Microsoft JScript. 16 bit yang lebih rendah dari nomor kesalahan sesuai dengan nilai yang ditemukan dalam Pesan Kesalahan.

Catatan

Untuk Windows XP dan Windows 2000, lihat Persyaratan Run-Time.

Persyaratan

Persyaratan	Nilai
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]
Redistribusi	WinHTTP 5.0 dan Internet Explorer 5.01 atau yang lebih baru pada Windows XP dan Windows 2000.
IDL	HttpRequest.idl
Pustaka	Winhttp.lib
DLL	Winhttp.dll

Lihat juga

Versi WinHTTP