CertificateStatus Property  
 

Return the status of the server certificate.

Syntax

object.CertificateStatus

Remarks

The CertificateStatus property may return one of the following values:

Value Constant Description
0 mailCertificateNone No certificate information is available. A secure connection was not established with the server.
1 mailCertificateValid The certificate is valid.
2 mailCertificateNoMatch The certificate is valid, however the domain name specified in the certificate does not match the domain name of the site that the client has connected to. This is typically the case if the ServerName property is set to an IP address rather than a host name. It is recommended that the client examine the CertificateSubject property to determine the domain name of the site that the certificate was issued for.
3 mailCertificateExpired The certificate has expired and is no longer valid. The client can examine the CertificateExpires property to determine when the certificate expired.
4 mailCertificateRevoked The certificate has been revoked and is no longer valid. It is recommended that the client application immediately terminate the connection if this status is returned.
5 mailCertificateUntrusted The certificate has not been issued by a trusted authority, or the certificate is not trusted on the local host. It is recommended that the client application immediately terminate the connection if this status is returned.
6 mailCertificateInvalid The certificate is invalid. This typically indicates that the internal structure of the certificate is damaged. It is recommended that the client application immediately terminate the connection if this status is returned.

This property value should be checked after the connection to the server has completed, but prior to beginning a transaction. If a secure connection has not been established, this property will return a value of zero.

Data Type

String

See Also

CertificateExpires Property, CertificateIssued Property, CertificateIssuer Property, CertificateSubject Property, Secure Property