Metode IWinHttpRequest::SetClientCertificate
Metode SetClientCertificate memilih sertifikat klien untuk dikirim ke server Secure Hypertext Transfer Protocol (HTTPS).
Sintaks
HRESULT SetClientCertificate(
[in] BSTR ClientCertificate
);
Parameter
-
ClientCertificate [in]
-
Menentukan lokasi, penyimpanan sertifikat, dan subjek sertifikat klien.
Mengembalikan nilai
Nilai yang dikembalikan S_OK pada keberhasilan atau nilai kesalahan jika tidak.
Keterangan
String yang ditentukan dalam parameter ClientCertificate terdiri dari lokasi sertifikat, penyimpanan sertifikat, dan nama subjek yang dibatasi oleh garis miring terbalik. Untuk informasi selengkapnya tentang komponen string sertifikat, lihat Sertifikat Klien.
Nama dan lokasi penyimpanan sertifikat bersifat opsional. Namun, jika Anda menentukan penyimpanan sertifikat, Anda juga harus menentukan lokasi penyimpanan sertifikat tersebut. Lokasi default adalah CURRENT_USER dan penyimpanan sertifikat default adalah "MY". Subjek kosong menunjukkan bahwa sertifikat pertama di penyimpanan sertifikat harus digunakan.
Panggil SetClientCertificate untuk memilih sertifikat sebelum memanggil Kirim untuk mengirim permintaan.
Microsoft Windows HTTP Services (WinHTTP) tidak menyediakan sertifikat klien ke server proksi yang meminta sertifikat untuk autentikasi.
Catatan
Untuk Windows XP dan Windows 2000, lihat bagian Persyaratan Run-Time di Halaman Mulai WinHTTP.
Contoh
Contoh pembuatan skrip berikut menunjukkan cara memilih sertifikat klien untuk dikirim dengan permintaan. Sertifikat dengan subjek "Sertifikat Middle-Tier Saya" dipilih dari penyimpanan sertifikat "Pribadi" di registri di bawah HKEY_LOCAL_MACHINE. Karena contoh kode ini khusus untuk Microsoft JScript, yang menggunakan garis miring terbalik sebagai karakter escape, dua garis miring terbalik yang berdekatan diperlukan untuk memisahkan komponen string sertifikat.
// Instantiate a WinHttpRequest object.
var HttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
// Open an HTTP connection.
HttpReq.Open("GET", "https://www.fabrikam.com/", false);
// Select a client certificate.
HttpReq.SetClientCertificate(
"LOCAL_MACHINE\\Personal\\My Middle-Tier Certificate");
// Send the HTTP Request.
HttpReq.Send();
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 |
|
| Pustaka |
|
| DLL |
|