Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch
Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

HttpListenerRequest.ClientCertificateError-Eigenschaft

Ruft einen Fehlercode ab, der ein Problem mit dem vom Client bereitgestellten X509Certificate bezeichnet.

Namespace:  System.Net
Assembly:  System (in System.dll)

public int ClientCertificateError { get; }

Eigenschaftswert

Typ: System.Int32
Ein Int32-Wert, der einen Windows-Fehlercode enthält.

AusnahmeBedingung
InvalidOperationException

Das Clientzertifikat wurde noch nicht von einem Aufruf der BeginGetClientCertificate-Methode oder GetClientCertificate-Methode initialisiert

– oder –

Der Vorgang wird immer noch ausgeführt.

Diese Eigenschaft enthält einen Windows-Fehlercode, der von der Schannel (Secure Channel)-SSPI (Security Support Provider Interface) zurückgegeben wird, mit der das Zertifikat überprüft wird. Weitere Informationen über SSPI-Unterstützung für Schannel finden Sie unter "Creating a Secure Connection Using Schannel" in der Dokumentation zu Sicherheit unter http://msdn.microsoft.com/de-de/library/default.aspx.

Im folgenden Codebeispiel wird diese Eigenschaft überprüft, um zu bestimmen, ob die Anforderung ein gültiges Clientzertifikat enthält.


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;
}


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Anzeigen: