ValidateDomains Method

Validate domains in a server certificate against endpoint used for connection. A url mismatch can be accepted by the certificate validation event, otherwise an exception is thrown.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Sub ValidateDomains( _
   ByVal serverCertificate As X509Certificate2, _
   ByVal endpoint As ConfiguredEndpoint, _
   Optional ByVal serverValidation As Boolean _
)

'Usage
 
Dim instance As CertificateValidator
Dim serverCertificate As X509Certificate2
Dim endpoint As ConfiguredEndpoint
Dim serverValidation As Boolean
 
instance.ValidateDomains(serverCertificate, endpoint, serverValidation)

public void ValidateDomains( 
   X509Certificate2 serverCertificate,
   ConfiguredEndpoint endpoint,
   bool serverValidation
)

public:
void ValidateDomains( 
   X509Certificate2^ serverCertificate,
   ConfiguredEndpoint^ endpoint,
   bool serverValidation
)

Parameters

serverCertificate: The server certificate which contains the list of domains.
endpoint: The endpoint used to connect to a server.
serverValidation: if the domain validation is called by a server or client.

Exceptions

Exception	Description
ServiceResultException	StatusCodes.BadCertificateHostNameInvalidif the endpoint can not be found in the list of domais in the certificate.

Remarks

On a client: the endpoint is only checked if the certificate is not already validated. A rejected server certificate is saved. On a server: the endpoint is always checked but the certificate is not saved.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

CertificateValidator Class
CertificateValidator Members