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 und den Betreff eines Clientzertifikats an.
Rückgabewert
Der Rückgabewert wird bei Erfolg S_OK oder andernfalls ein Fehlerwert.
Bemerkungen
Die im ClientCertificate-Parameter angegebene Zeichenfolge besteht aus dem Zertifikatspeicherort, dem Zertifikatspeicher und dem Antragstellernamen, der durch umgekehrte Schrägstriche getrennt ist. Weitere Informationen zu den Komponenten der Zertifikatzeichenfolge finden Sie unter Clientzertifikate.
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 Antragsteller gibt an, dass das erste Zertifikat im Zertifikatspeicher verwendet werden soll.
Rufen Sie SetClientCertificate auf, um ein Zertifikat auszuwählen, bevor Sie Senden aufrufen, um die Anforderung zu senden.
Microsoft Windows HTTP Services (WinHTTP) stellt keine Clientzertifikate für Proxyserver bereit, die Zertifikate für die Authentifizierung anfordern.
Hinweis
Informationen zu 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 "My Middle-Tier Certificate" wird aus dem Zertifikatspeicher "Persönlich" in der Registrierung unter HKEY_LOCAL_MACHINE ausgewählt. Da dieses Codebeispiel spezifisch für Microsoft JScript ist, das den umgekehrten Schrägstrich als Escapezeichen verwendet, sind zwei benachbarte umgekehrte Schrägstriche erforderlich, um Komponenten der Zertifikatzeichenfolge zu trennen.
// 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();
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps] |
| Verteilbare Komponente |
WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000. |
| IDL |
|
| Bibliothek |
|
| DLL |
|