WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsISmtpService

IID:2B7FA4A1-A73E-4B7A-A789-7D0CFBE5AC97
Inherits From:nsISupports

This interface is intended to be used as a service.

This interface is implemented by the following components:

Properties

nsISmtpServer defaultServer

The default server, across sessions of the app (eventually there will be a session default which does not persist past shutdown)

nsISmtpServer sessionDefaultServer

The "session default" server - this is never saved, and only used for the current session. Always falls back to the default server unless explicitly set.

readonly nsISupportsArray smtpServers

A copy of the array of SMTP servers, as stored in the preferences

Methods

nsISmtpServer createSmtpServer ( ) void deleteSmtpServer ( nsISmtpServer server ) nsISmtpServer findServer ( char* username , char* hostname ) nsISmtpServer getServerByKey ( char* key ) void GetSmtpServerByIdentity ( nsIMsgIdentity senderIdentity , out nsISmtpServer server ) void SendMailMessage ( nsIFile filePath , char* recipients , nsIMsgIdentity senderIdentity , char* password , nsIUrlListener urlListener , nsIMsgStatusFeedback statusListener , nsIInterfaceRequestor notificationCallbacks , PRBool requestDSN , out nsIURI URL , out nsIRequest request )

nsISmtpServer createSmtpServer ( )

Create a new SMTP server. Use this instead of createInstance(), so that the SMTP Service can be aware of this server

void deleteSmtpServer ( nsISmtpServer server )

Delete the given server from the server list. does nothing if the server does not exist

Arguments:
server: the server to delete. Use findServer() if you only know the hostname

nsISmtpServer findServer ( char* username , char* hostname )

Find the server with the given hostname.

Arguments:
username
hostname: the hostname of the server

nsISmtpServer getServerByKey ( char* key )

Look up the server with the given key if the server does not exist, create it and add it to our list

Arguments:
key

void GetSmtpServerByIdentity ( nsIMsgIdentity senderIdentity , out nsISmtpServer server )

Return the SMTP server that is associated with an identity.

Arguments:
senderIdentity
server

void SendMailMessage ( nsIFile filePath , char* recipients , nsIMsgIdentity senderIdentity , char* password , nsIUrlListener urlListener , nsIMsgStatusFeedback statusListener , nsIInterfaceRequestor notificationCallbacks , PRBool requestDSN , out nsIURI URL , out nsIRequest request )

Arguments:
filePath
recipients
senderIdentity
password
urlListener
statusListener
notificationCallbacks
requestDSN
URL
request

Reference documentation is generated from Mozilla's source.