wodSmtp ActiveX Control - HostCertificate Method
 HostCertificate Method
      
 

Description

Called when remote server provides its certificate.


Return Type

None  


Syntax

object.HostCertificate Owner, Cert, ErrorCode, ErrorText, Accept



The HostCertificate Method syntax has these parts:

Part Description
object An expression evaluating to an object of type wodSmtpClientNotify.
Owner A wodSmtpCom object. Reference to wodSmtpCom instance that called this callback method.
Cert An ICertificate object. Holds information about server's certificate.
ErrorCode A Long value. Code for certificate error, if any.
ErrorText A String value. Text description of the error, if any.
Accept A Boolean value. When set to False wodSmtp will close the connection.

Remarks

NOTE: This method is called only if you implemented IwodSmtpClientNotify interface in your application, and wodSmtp1.Notification property has received reference to instance of your implementation.

Once wodSmtp connects to SSL/TLS server, it will receive server's certificate that holds information about server's validity. It will contain information such as server's name, organization, valid dates etc.. Certificates are usually signed by some known CA (Certificate Authority) whose responsibility is to prove that server is really the one he's representing to be.

wodSmtp will try to detect if remote certificate should be trusted or not. If any errors are found, ErrorText will contain line-by-line descriptions for all errors found, and ErrorCode will contain first error that was found. If ErrorText is empty (and ErrorCode is 0), certificate should be trusted. wodSmtp will load all certificates in your Windows Certificate store (ROOT and MY stores) and remote certificate will be tested against all certificates in those stores.

Even if no error is found - make sure certificate's CommonName property point to the Hostname you're connecting to! This test should be done by your application.

If you think remote server's certificate is invalid, you should set Accept parameter to False and wodSmtp will immediately close the connection.