StreamWebSocketControl.IgnorableServerCertificateErrors Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Liste der fehlerablen Serverzertifikate 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:// Protocol) 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 angibt, welche Serverzertifikatfehler beim Überprüfen von Serverzertifikaten ignoriert werden sollen. Standardmäßig ist die Liste leer, und alle Fehler führen dazu, dass die Überprüfung fehlschlägt.
Implementiert
Windows-Anforderungen
Gerätefamilie |
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)
|
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie sie den ChainValidationResult.Untrusted-Fehler ignorieren, 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, aber andere Fehler bei der Überprüfung des Serverzertifikats führen weiterhin dazu, dass ConnectAsync fehlschlägt.
private async void CreateAndConnectWebSocket()
{
var myWebSocket = new StreamWebSocket();
myWebSocket.Information.IgnorableServerCertificateErrors.Add(ChainValidationResult.Untrusted);
...
await myWebSocket.ConnectAsync(new Uri("wss://contoso.com/wsendpoint1"));
}