Metodo IWinHttpRequest::SetClientCertificate
Il metodo SetClientCertificate seleziona un certificato client da inviare a un server HTTPS (Secure Hypertext Transfer Protocol).
Sintassi
HRESULT SetClientCertificate(
[in] BSTR ClientCertificate
);
Parametri
-
ClientCertificate [in]
-
Specifica il percorso, l'archivio certificati e l'oggetto di un certificato client.
Valore restituito
Il valore restituito è S_OK in caso di esito positivo o di un valore di errore in caso contrario.
Commenti
La stringa specificata nel parametro ClientCertificate è costituita dal percorso del certificato, dall'archivio certificati e dal nome soggetto delimitato da barre rovesciate. Per altre informazioni sui componenti della stringa di certificato, vedere Certificati client.
Il nome e la posizione dell'archivio certificati sono facoltativi. Tuttavia, se si specifica un archivio certificati, è necessario specificare anche il percorso dell'archivio certificati. Il percorso predefinito è CURRENT_USER e l'archivio certificati predefinito è "MY". Un oggetto vuoto indica che il primo certificato nell'archivio certificati deve essere usato.
Chiamare SetClientCertificate per selezionare un certificato prima di chiamare Invia per inviare la richiesta.
Microsoft Windows HTTP Services (WinHTTP) non fornisce certificati client ai server proxy che richiedono certificati per l'autenticazione.
Nota
Per Windows XP e Windows 2000, vedere la sezione Requisiti di runtime della pagina iniziale WinHTTP.
Esempio
Nell'esempio di scripting seguente viene illustrato come selezionare un certificato client da inviare con una richiesta. Un certificato con l'oggetto "Certificato Middle-Tier" viene scelto dall'archivio certificati "Personale" nel Registro di sistema in HKEY_LOCAL_MACHINE. Poiché questo esempio di codice è specifico di Microsoft JScript, che usa la barra rovesciata come carattere di escape, sono necessarie due barre rovesciate adiacenti per delimitare i componenti della stringa del certificato.
// 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();
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP, Windows 2000 Professional con SP3 [solo app desktop] |
| Server minimo supportato |
Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop] |
| Componente ridistribuibile |
WinHTTP 5.0 e Internet Explorer 5.01 o versione successiva in Windows XP e Windows 2000. |
| IDL |
|
| Libreria |
|
| DLL |
|