Sprache

StreamWebSocketControl.IgnorableServerCertificateErrors Eigenschaft

Definition

Ruft eine Liste der ignorablen Serverzertifikatfehler ab. Rufen Sie diese Liste ab, und fügen Sie ChainValidationResult-Werte für Serverzertifikatfehler hinzu, die Sie während des Überprüfungsprozesses für sichere WebSocket-Serverzertifikate (wss:// Protokoll) ignorieren möchten.

public:
 property IVector<ChainValidationResult> ^ IgnorableServerCertificateErrors { IVector<ChainValidationResult> ^ get(); };
IVector<ChainValidationResult> IgnorableServerCertificateErrors();
public IList<ChainValidationResult> IgnorableServerCertificateErrors { get; }
var iVector = streamWebSocketControl.ignorableServerCertificateErrors;
Public ReadOnly Property IgnorableServerCertificateErrors As IList(Of ChainValidationResult)

Eigenschaftswert

Eine Liste der ChainValidationResult-Werte , die die Serverzertifikatfehler angeben, die beim Überprüfen von Serverzertifikaten ignoriert werden sollen. Standardmäßig ist die Liste leer, und alle Fehler verursachen einen Fehler bei der Überprüfung.

Implementiert

Windows-Anforderungen

Anforderungen Beschreibung
Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Beispiele

Das folgende Beispiel veranschaulicht, wie der ChainValidationResult.Untrusted-Fehler ignoriert wird, wenn Sie eine Verbindung mit einem Server herstellen, der ein selbstsigniertes Zertifikat verwendet. Der Code fügt der Liste "IgnorableServerCertificateErrors" den entsprechenden Wert hinzu, bevor ConnectAsync im Websocket aufgerufen wird. Das selbstsignierte Zertifikat des Servers führt nicht dazu, dass die Überprüfung fehlschlägt, andere Fehler beim Überprüfen des Serverzertifikats führen jedoch zu einem Fehler bei ConnectAsync .

private async void CreateAndConnectWebSocket()
{
    var myWebSocket = new StreamWebSocket();
    myWebSocket.Information.IgnorableServerCertificateErrors.Add(ChainValidationResult.Untrusted);

    ...

    await myWebSocket.ConnectAsync(new Uri("wss://contoso.com/wsendpoint1"));

}

Gilt für: