HttpListenerRequest.ClientCertificateError Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un codice di errore che identifica un problema con la classe X509Certificate fornita dal client.
public:
property int ClientCertificateError { int get(); };
public int ClientCertificateError { get; }
member this.ClientCertificateError : int
Public ReadOnly Property ClientCertificateError As Integer
Valore della proprietà
Valore Int32 contenente un codice di errore di Windows.
Eccezioni
Il certificato client non è stato ancora inizializzato da una chiamata ai metodi BeginGetClientCertificate(AsyncCallback, Object) o GetClientCertificate()
-oppure-
L'operazione è ancora in corso.
Esempio
Nell'esempio di codice seguente questa proprietà viene controllata per determinare se la richiesta include un certificato client valido.
Console.WriteLine("Listening for {0} prefixes...", listener.Prefixes.Count);
HttpListenerContext context = listener.GetContext();
HttpListenerRequest request = context.Request;
Console.WriteLine("Received a request.");
// This server requires a valid client certificate
// for requests that are not sent from the local computer.
// Did the client omit the certificate or send an invalid certificate?
if (request.IsAuthenticated &&
request.GetClientCertificate() == null ||
request.ClientCertificateError != 0)
{
// Send a 403 response.
HttpListenerResponse badCertificateResponse = context.Response ;
SendBadCertificateResponse(badCertificateResponse);
Console.WriteLine("Client has invalid certificate.");
continue;
}
Console.WriteLine("Listening for {0} prefixes...", listener.Prefixes.Count)
Dim context As HttpListenerContext = listener.GetContext()
Dim request As HttpListenerRequest = context.Request
Console.WriteLine("Received a request.")
' This server requires a valid client certificate
' for requests that are not sent from the local computer.
' Did the client omit the certificate or send an invalid certificate?
If request.IsAuthenticated AndAlso request.GetClientCertificate() Is Nothing OrElse request.ClientCertificateError <> 0 Then
' Send a 403 response.
Dim badCertificateResponse As HttpListenerResponse = context.Response
SendBadCertificateResponse(badCertificateResponse)
Console.WriteLine("Client has invalid certificate.")
Continue Do
End If
Commenti
Questa proprietà contiene un codice di errore di Windows restituito da Secure Channel (Schannel) Security Support Provider Interface (SSPI), che viene usato per convalidare il certificato. Per altre informazioni sul supporto SSPI per Schannel, vedere Creating a Secure Connection Using Schannel.For more information about SSPI support for Schannel, see Creating a Secure Connection Using Schannel.