Login Method

Description

Establish a session with a server.

Syntax

Visual Basic
Public Sub Login( _ ByVal Server As String, _ Optional ByVal RemotePort As Long = 0, _ Optional ByVal Username As String, _ Optional ByVal Password As String _ )

Visual Basic

Public Sub Login( _
   ByVal Server As String, _
   Optional ByVal RemotePort As Long = 0, _
   Optional ByVal Username As String, _
   Optional ByVal Password As String _
)

Parameters

Server: A hostname or IP address.
RemotePort: Specifies the port number you wish to connect to. Defaults to the well-known port 25 (or 465 for implicitly secure connections).
Username: Specifies the server account.
Password: Specifies the Password.

Remarks

After a successful Login, the supported server extensions are listed in the Capabilities property and will be used when applicable. See the Capabilities property or the SMTP Protocol Overview section for more information regarding SMTP extensions.

See SMTP Control Event Sequencing for event information related to this method and SMTP Control Non-Blocking Sample for information on non-blocking operation.

Error Codes

This method may generate the following error code (refer to MailErrorConstants for a complete list of error codes):

ptAbort
ptAddressInUse
ptAddressNotAvailable
ptAuthentication (An Invalid Username or Password was specified)
ptBlocked
ptConnected
ptConnectionAborted
ptConnectionReset
ptConnectionRefused
ptHostNotFound
ptNetworkDown
ptNetworkReset
ptNetworkUnreachable
ptNoBufferSpace
ptNoData
ptNotInitialized
ptProtocol (A protocol error was encountered)
ptTimeout
ptTryAgain