SMTPClient Component
Properties Methods Events Configuration Settings Errors
The SMTPClient component provides client-side functionality for SMTP (Simple Mail Transfer Protocol).
Syntax
SecureBlackbox.Smtpclient
Remarks
Use this component to send e-mails from your application.
Property List
The following is the full list of the properties of the component with short descriptions. Click on the links for further details.
| BlockedCertificates | The certificates that must be rejected as trust anchors. |
| ClientChain | The TLS client certificate chain. |
| ConnectionInfo | Returns the details of the underlying network connection. |
| Domain | The sender host's domain name for HELO/EHLO. |
| ExternalCrypto | Provides access to external signing and DC parameters. |
| KnownCertificates | Additional certificates for chain validation. |
| KnownCRLs | Additional CRLs for chain validation. |
| KnownOCSPs | Additional OCSP responses for chain validation. |
| Message | Contains an e-mail message. |
| Password | The authentication password. |
| Proxy | The proxy server settings. |
| ServerChain | The TLS server's certificate chain. |
| ServerInfo | Encapsulates information about the server. |
| SocketSettings | Manages network connection settings. |
| TLSSettings | Manages TLS layer settings. |
| TrustedCertificates | A list of trusted certificates for chain validation. |
| Username | The authentication username. |
Method List
The following is the full list of the methods of the component with short descriptions. Click on the links for further details.
| config | Sets or retrieves a configuration setting. |
| connect | Establishes a connection to the SMTP server. |
| disconnect | Closes connection to the SMTP server. |
| sendBytes | Sends an e-mail message stored in a byte array. |
| sendFile | Sends an e-mail message stored in a file. |
| sendMessage | Sends a message to the SMTP server. |
| sendStream | Sends an e-mail message stored in a stream. |
Event List
The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.
| BeforeAuth | Fires before the authentication starts. |
| CertificateValidate | Fires when the server's TLS certificate has to be validated. |
| Command | Reports a command sent to the server. |
| CommandData | Returns the data that accompanies the command. |
| CommandReply | Reports the receipt of a reply to a command. |
| Error | Provides information about errors during SMTP operations. |
| ExternalSign | Handles remote or external signing initiated by the SignExternal method or other source. |
| Notification | This event notifies the application about an underlying control flow event. |
| Progress | Reports the progress of the data transfer operation. |
Configuration Settings
The following is a list of configuration settings for the component with short descriptions. Click on the links for further details.
| Authentications | Specifies enabled authentication methods and their priorities. |
| BinaryChunkSize | Specifies the size of chunks to use for dividing outgoing messages in binary mode. |
| BinaryMode | Specifies whether binary mode is allowed for sending. |
| ForceLogin | Forces the component to login to the server. |
| IgnoreSystemTrust | Whether trusted Windows Certificate Stores should be treated as trusted. |
| RemoveBCC | Specifies if BCC header fields should be removed from messages. |
| SendBufferSize | Size of send buffer in bytes. |
| TempPath | Path for storing temporary files. |
| TolerateMinorChainIssues | Whether to tolerate minor chain issues. |
| UseMicrosoftCTL | Enables or disables automatic use of Microsoft online certificate trust list. |
| UseSystemCertificates | Enables or disables the use of the system certificates. |
| CheckKeyIntegrityBeforeUse | Enables or disable private key integrity check before use. |
| CookieCaching | Specifies whether a cookie cache should be used for HTTP(S) transports. |
| Cookies | Gets or sets local cookies for the component (supported for HTTPClient, RESTClient and SOAPClient only). |
| DefDeriveKeyIterations | Specifies the default key derivation algorithm iteration count. |
| EnableClientSideSSLFFDHE | Enables or disables finite field DHE key exchange support in TLS clients. |
| GlobalCookies | Gets or sets global cookies for all the HTTP transports. |
| HttpUserAgent | Specifies the user agent name to be used by all HTTP clients. |
| LogDestination | Specifies the debug log destination. |
| LogDetails | Specifies the debug log details to dump. |
| LogFile | Specifies the debug log filename. |
| LogFilters | Specifies the debug log filters. |
| LogFlushMode | Specifies the log flush mode. |
| LogLevel | Specifies the debug log level. |
| LogMaxEventCount | Specifies the maximum number of events to cache before further action is taken. |
| LogRotationMode | Specifies the log rotation mode. |
| MaxASN1BufferLength | Specifies the maximal allowed length for ASN.1 primitive tag data. |
| MaxASN1TreeDepth | Specifies the maximal depth for processed ASN.1 trees. |
| OCSPHashAlgorithm | Specifies the hash algorithm to be used to identify certificates in OCSP requests. |
| UseOwnDNSResolver | Specifies whether the client components should use own DNS resolver. |
| UseSharedSystemStorages | Specifies whether the validation engine should use a global per-process copy of the system certificate stores. |
| UseSystemOAEPAndPSS | Enforces or disables the use of system-driven RSA OAEP and PSS computations. |
| UseSystemRandom | Enables or disables the use of the OS PRNG. |