Description
-
Fires when remote server provides its certificate.
Syntax
-
Private Sub
object_HostCertificate(Cert, ErrorCode,
ErrorText, Accept)
The HostCertificate Event syntax has these parts:
| object |
A wodSmtp object. |
|
Cert |
An ICertificate object.
Reference to Certificate object that holds information about
server's certificate. |
|
ErrorCode |
A Long value. Code of the
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
-
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.
|
HostCertificate Event
