HttpListenerRequest.ClientCertificateError Własność
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
Pobiera kod błędu, który identyfikuje problem z X509Certificate podanym przez klienta.
public:
property int ClientCertificateError { int get(); };public int ClientCertificateError { get; }member this.ClientCertificateError : intPublic ReadOnly Property ClientCertificateError As IntegerWartość nieruchomości
Wartość zawierająca Int32 kod błędu systemu Windows.
Wyjątki
Certyfikat klienta nie został jeszcze zainicjowany przez wywołanie BeginGetClientCertificate(AsyncCallback, Object) metody lub GetClientCertificate()
-Lub-
Operacja jest nadal w toku.
Przykłady
Poniższy przykład kodu sprawdza tę właściwość, aby określić, czy żądanie zawiera prawidłowy certyfikat klienta.
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
Uwagi
Ta właściwość zawiera kod błędu systemu Windows zwrócony przez interfejs dostawcy obsługi zabezpieczeń bezpiecznego kanału (SSPI), który jest używany do sprawdzania poprawności certyfikatu. Aby uzyskać więcej informacji na temat obsługi interfejsu SSPI dla protokołu Schannel, zobacz Tworzenie bezpiecznego połączenia przy użyciu protokołu Schannel.
