IWebSocketInformation2 IWebSocketInformation2 IWebSocketInformation2 IWebSocketInformation2 Interface

Definition

Provides socket information on an IWebSocket object. This interface extends IWebSocketInformation with additional properties.

public : interface IWebSocketInformation2public interface IWebSocketInformation2Public Interface IWebSocketInformation2// You can use this interface in JavaScript.
Inheritance
IWebSocketInformation2IWebSocketInformation2IWebSocketInformation2IWebSocketInformation2
Attributes
Windows 10 requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Inherited Members

Inherited properties

Properties

ServerCertificate ServerCertificate ServerCertificate ServerCertificate

Gets the certificate provided by the server when a secure WebSocket connection has been established.

public : Certificate ServerCertificate { get; }public Certificate ServerCertificate { get; }Public ReadOnly Property ServerCertificate As Certificate// You can use this property in JavaScript.
Value
Certificate Certificate Certificate Certificate

The server certificate.

Remarks

By the time the server certificate is available through this property, the SSL connection has already been established.

If you wish to inspect the server certificate during the connection process in order to perform custom validation, you should register a handler for the appropriate MessageWebSocket.ServerCustomValidationRequested or StreamWebSocket.ServerCustomValidationRequested event, and perform your custom server validation in that handler.

If you merely wish to ignore certain classes of error when the server certificate is validated (for example, you are using a self-signed certificate and wish to ignore the validation error caused by this condition) you can use the IgnorableServerCertificateErrors property to ignore the relevant classes of errors.

ServerCertificateErrors ServerCertificateErrors ServerCertificateErrors ServerCertificateErrors

Gets a list of the errors that occurred while establishing a secure WebSocket connection.

public : IVectorView<ChainValidationResult> ServerCertificateErrors { get; }public IReadOnlyList<ChainValidationResult> ServerCertificateErrors { get; }Public ReadOnly Property ServerCertificateErrors As IReadOnlyList<ChainValidationResult>// You can use this property in JavaScript.
Value
IVectorView<ChainValidationResult> IReadOnlyList<ChainValidationResult> IReadOnlyList<ChainValidationResult> IReadOnlyList<ChainValidationResult>

A list of values describing secure connection errors.

ServerCertificateErrorSeverity ServerCertificateErrorSeverity ServerCertificateErrorSeverity ServerCertificateErrorSeverity

Gets the category of an error that occurred making an SSL connection with a WebSocket server.

public : SocketSslErrorSeverity ServerCertificateErrorSeverity { get; }public SocketSslErrorSeverity ServerCertificateErrorSeverity { get; }Public ReadOnly Property ServerCertificateErrorSeverity As SocketSslErrorSeverity// You can use this property in JavaScript.

Remarks

SSL server errors should only be ignored in advanced scenarios. Disregarding server certificate errors when this property is either Ignorable or Fatal may result in the loss of privacy or integrity of the content passed over the SSL session.

ServerIntermediateCertificates ServerIntermediateCertificates ServerIntermediateCertificates ServerIntermediateCertificates

Gets the intermediate certificates sent by the server during SSL negotiation when making an SSL connection with a WebSockets server.

public : IVectorView<Certificate> ServerIntermediateCertificates { get; }public IReadOnlyList<Certificate> ServerIntermediateCertificates { get; }Public ReadOnly Property ServerIntermediateCertificates As IReadOnlyList<Certificate>// You can use this property in JavaScript.
Value
IVectorView<Certificate> IReadOnlyList<Certificate> IReadOnlyList<Certificate> IReadOnlyList<Certificate>

The set of certificates sent by the server during SSL negotiation.

Remarks

This property returns the intermediate server certificates used when making an SSL connection with a WebSockets server. These certificates are provided by the server during the SSL connection negotiation. The properties on the Certificate objects in the returned vector can be used to get detailed information on the certificates.

By the time the list of intermediate certificates is available through this property, the SSL connection has already been established. If you wish to inspect the server certificates during the connection process in order to perform custom validation, you should register a handler for the appropriate MessageWebSocket.ServerCustomValidationRequested or StreamWebSocket.ServerCustomValidationRequested event, and perform your custom server validation in that handler, using the WebSocketServerCustomValidationRequestedEventArgs instance passed to your event handler to inspect the intermediate certificates.

See Also