1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#include "nsISupports.idl"
#include "MailNewsTypes2.idl"
interface nsIAuthPrompt;
interface nsIUrlListener;
interface nsIURI;
interface nsIMsgWindow;
/**
* This interface represents a single SMTP Server. A SMTP server instance may be
* created/obtained from nsIMsgAccountManager.
*
* Most of the attributes will set/get preferences from the main preferences
* file.
*/
[scriptable, uuid(a53dce6c-cd81-495c-83bc-45a65df1f08e)]
interface nsISmtpServer : nsISupports {
/// A unique identifier for the server.
attribute string key;
/// A user supplied description for the server.
attribute AUTF8String description;
/// The server's hostname.
attribute ACString hostname;
/// The server's port.
attribute int32_t port;
/// The username to access the server with (if required)
attribute ACString username;
/**
* The password to access the server with (if required).
*
* @note this is stored within the server instance but not within preferences.
* It can be specified/saved here to avoid prompting the user constantly for
* the sending password.
*/
attribute ACString password;
/// Returns a displayname of the format hostname:port or just hostname
readonly attribute string displayname;
/**
* Authentication mechanism.
*
* @see nsMsgAuthMethod (in MailNewsTypes2.idl)
* Same as "mail.smtpserver...authMethod" pref
*
* Compatibility note: This attribute had a different meaning in TB < 3.1
*/
attribute nsMsgAuthMethodValue authMethod;
/**
* Whether to SSL or STARTTLS or not
*
* @see nsMsgSocketType (in MailNewsTypes2.idl)
* Same as "mail.smtpserver...try_ssl" pref
*/
attribute nsMsgSocketTypeValue socketType;
/**
* May contain an alternative argument to EHLO or HELO to provide to the
* server. Reflects the value of the mail.smtpserver.*.hello_argument pref.
* This is mainly useful where ISPs don't bother providing PTR records for
* their servers and therefore users get an error on sending. See bug 244030
* for more discussion.
*/
readonly attribute string helloArgument;
/// Returns the URI of the server (smtp:///)
readonly attribute ACString serverURI;
/**
* Gets a password for this server, using a UI prompt if necessary.
*
* @param promptString The string to prompt the user with when asking for
* the password.
* @param promptTitle The title of the prompt.
* @param netPrompt An nsIAuthPrompt instance to use for the password
* prompt.
* @return The password to use (may be null if no password was
* obtained).
*/
ACString getPasswordWithUI(in wstring promptString, in wstring promptTitle,
in nsIAuthPrompt netPrompt);
/**
* Gets a username and password for this server, using a UI prompt if
* necessary.
*
* @param promptString The string to prompt the user with when asking for
* the password.
* @param promptTitle The title of the prompt.
* @param netPrompt An nsIAuthPrompt instance to use for the password
* prompt.
* @param userid The username to use (may be null if no password was
* obtained).
* @param password The password to use (may be empty if no password was
* obtained).
*/
void getUsernamePasswordWithUI(in wstring promptString, in wstring promptTitle,
in nsIAuthPrompt netPrompt, out ACString userid,
out ACString password);
/**
* Calling this will *remove* the saved password for this server from the
* password manager and from the stored value.
*/
void forgetPassword();
/**
* Verify that we can logon
*
* @param aPassword - password to use
* @param aUrlListener - gets called back with success or failure.
* @return - the url that we run.
*
*/
nsIURI verifyLogon(in nsIUrlListener aUrlListener, in nsIMsgWindow aMsgWindow);
/// Call this to clear all preference values for this server.
void clearAllValues();
};
|
