IWinHttpRequest::SetClientCertificate-Methode

Die SetClientCertificate-Methode wählt ein Clientzertifikat aus, das an einen HTTPS-Server (Secure Hypertext Transfer Protocol) gesendet werden soll.

Syntax

HRESULT SetClientCertificate(
  [in] BSTR ClientCertificate
);

Parameter

ClientCertificate [ In]

Gibt den Speicherort, den Zertifikatspeicher undden Betreff eines Clientzertifikats an.

Rückgabewert

Der Rückgabewert ist S _ OK bei Erfolg oder andernfalls ein Fehlerwert.

Bemerkungen

Die im ClientCertificate-Parameter angegebene Zeichenfolge besteht aus dem Speicherort des Zertifikats, dem Zertifikatspeicher und dem Namen des Subjekts, getrennt durch schräge Schrägstriche. Weitere Informationen zu den Komponenten der Zertifikatzeichenfolge finden Sie unter Clientzertifikate.

Der Name und Speicherort des Zertifikatspeichers sind optional. Wenn Sie jedoch einen Zertifikatspeicher angeben, müssen Sie auch den Speicherort dieses Zertifikatspeichers angeben. Der Standardspeicherort ist CURRENT _ USER, und der Standardzertifikatspeicher ist "MY". Ein leerer Betreff gibt an, dass das erste Zertifikat im Zertifikatspeicher verwendet werden soll.

Rufen Sie SetClientCertificate auf, um ein Zertifikat auszuwählen, bevor Sie Send aufrufen, um die Anforderung zu senden.

Microsoft Windows HTTP Services (WinHTTP) stellt keine Clientzertifikate für Proxyserver zur Verfügung, die Zertifikate für die Authentifizierung anfordern.

Hinweis

Informationen Windows XP und Windows 2000 finden Sie im Abschnitt Laufzeitanforderungen der WinHTTP-Startseite.

Beispiele

Das folgende Skriptbeispiel zeigt, wie Sie ein Clientzertifikat auswählen, das mit einer Anforderung gesendet werden soll. Ein Zertifikat mit dem Betreff "Mein Middle-Tier Zertifikat" wird aus dem "persönlichen" Zertifikatspeicher in der Registrierung unter HKEY _ LOCAL MACHINE _ ausgewählt. Da dieses Codebeispiel spezifisch für Microsoft JScript ist, bei dem der schräge Schrägstrich als Escapezeichen verwendet wird, sind zwei benachbarte schräge Schrägstriche erforderlich, um Komponenten der Zertifikatzeichenfolge zu begrenzen.

// 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();

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP, Windows 2000 Professional nur mit [ SP3-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003, Windows 2000 Server nur mit [ SP3-Desktop-Apps]
Verteilbare Komponente
WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000.
IDL
HttpRequest.idl
Bibliothek
Winhttp.lib
DLL
Winhttp.dll

Weitere Informationen

IWinHttpRequest

WinHttpRequest

SSL in WinHTTP

WinHTTP-Versionen