IXMLHTTPRequest2::Metode buka (msxml6.h)
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(&spXHR));
//
//Create and initialize an IXMLHTTPRequest2Callback object
//
hr = MakeAndInitialize<CXMLHttpRequest2Callback>(&spXhrCallback);
hr = spXHR->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->Send(NULL, 0);
hr = spXhrCallback->WaitForComplete(&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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk