IXMLHTTPRequest2::Metode buka (msxml6.h)

Artikel
03/05/2024

Menginisialisasi permintaan IXMLHTTPRequest2 dan menentukan metode, URL, dan informasi autentikasi untuk permintaan tersebut. Setelah memanggil metode ini, Anda harus memanggil metode Kirim untuk mengirim permintaan dan data, jika ada, ke server.

Sintaks

HRESULT Open(
  [in]           const WCHAR              *pwszMethod,
  [in]           const WCHAR              *pwszUrl,
  [in, optional] IXMLHTTPRequest2Callback *pStatusCallback,
  [in, optional] const WCHAR              *pwszUserName,
  [in, optional] const WCHAR              *pwszPassword,
  [in, optional] const WCHAR              *pwszProxyUserName,
  [in, optional] const WCHAR              *pwszProxyPassword
);

Parameter

[in] pwszMethod

Metode HTTP yang digunakan untuk membuka koneksi, seperti GET atau POST. Untuk XMLHTTP, parameter ini tidak peka huruf besar/kecil.

[in] pwszUrl

URL yang diminta. Ini harus berupa URL absolut, seperti "http://Myserver/Mypath/Myfile.asp".

[in, optional] pStatusCallback

Antarmuka panggilan balik yang diimplementasikan oleh aplikasi yang menerima peristiwa panggilan balik.

Ketika Metode Kirim berhasil, metode pada antarmuka ini dipanggil untuk memproses respons atau peristiwa lainnya.

[in, optional] pwszUserName

Nama pengguna untuk autentikasi. Jika parameter ini adalah Null dan situs memerlukan autentikasi, kredensial akan dikelola oleh Windows, termasuk menampilkan UI masuk, kecuali dinonaktifkan oleh SetProperty.

[in, optional] pwszPassword

Kata sandi untuk autentikasi. Parameter ini diabaikan jika parameter pwszUserName null atau hilang.

[in, optional] pwszProxyUserName

Nama pengguna untuk autentikasi di server proksi. Jika parameter ini adalah string Null atau kosong dan situs memerlukan autentikasi, kredensial akan dikelola oleh Windows, termasuk menampilkan UI masuk, kecuali dinonaktifkan oleh SetProperty.

[in, optional] pwszProxyPassword

Kata sandi untuk autentikasi pada server proksi. Parameter ini diabaikan jika parameter pwszProxyUserName null atau hilang.

Mengembalikan nilai

Mengembalikan S_OK pada keberhasilan.

Keterangan

Meskipun metode ini menerima kredensial yang diteruskan melalui parameter, kredensial ini tidak secara otomatis dikirim ke server pada permintaan pertama. Parameter pwszUserName dan pwszPassword tidak dikirim ke server kecuali server menantang klien untuk kredensial dengan respons 401 - Tidak sah.

Contoh

//
// Create and initialize an IXMLHTTPRequest2 object
//
hr = CoCreateInstance(CLSID_FreeThreadedXMLHTTP60,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_PPV_ARGS(&amp;spXHR));

//
//Create and initialize an IXMLHTTPRequest2Callback object
//
hr = MakeAndInitialize&lt;CXMLHttpRequest2Callback&gt;(&amp;spXhrCallback);

hr = spXHR-&gt;Open(L"GET",              // Method.
                 pcwszUrl,            // Url.
                 spXhrCallback.Get(), // Callback.
                 NULL,                // Username.
                 NULL,                // Password.
                 NULL,                // Proxy username.
                 NULL);               // Proxy password.

//
//Send the GET request
//
hr = spXHR-&gt;Send(NULL, 0);

hr = spXhrCallback-&gt;WaitForComplete(&amp;dwStatus);

Untuk contoh lengkapnya, lihat sampel PERMINTAAN HTTP XML 2 GET dan sampel PERMINTAAN HTTP XML 2 POST.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP],MSXML 6.0 dan yang lebih baru
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	msxml6.h

Lihat juga

IXMLHTTPRequest2

Antarmuka IXMLHTTPRequest2Callback

Kirim Metode

Bagikan melalui