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	HttpRequest.idl
Pustaka	Winhttp.lib
DLL	Winhttp.dll

Lihat juga

IWinHttpRequest

WinHttpRequest

SSL di WinHTTP

Versi WinHTTP