2.2.3.3.1 AccountId (SendMail, SmartForward, SmartReply)
The AccountId element is an optional child element of the SendMail element in SendMail command requests, an optional child element of the SmartForward element in SmartForward command requests, and an optional child element of the SmartReply element in SmartReply command requests. In all contexts, it identifies the account from which an email is sent.
Elements referenced in this section are defined in the ComposeMail namespace, except where otherwise indicated by the presence of a namespace prefix (as defined in section 2.2.4).
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
---|---|---|---|---|
SendMail command request (section 2.2.1.17) |
SendMail (section 2.2.3.162) |
None |
string ([MS-ASDTYPE] section 2.7) |
0...1 (optional) |
SmartForward command request (section 2.2.1.19) |
SmartForward (section 2.2.3.169) |
None |
string |
0...1 (optional) |
SmartReply command request (section 2.2.1.20) |
SmartReply (section 2.2.3.170) |
None |
string |
0...1 (optional) |
If the AccountId element is not present in the request, the server sends the email using the account identified by the settings:PrimarySmtpAddress element (section 2.2.3.138) returned in the Settings command response (section 2.2.1.18).
If AccountId is included in the request, the value MUST equal one of the settings:AccountId element values included in the Settings command response.
The server MUST validate that the AccountId element value provided is valid for sending email. A Status element (section 2.2.3.177) value of 166 is returned if the AccountId element value is not valid. A Status element value of 167 is returned if the account does not support sending email.
Note The server sends the email using the account specified by the AccountId element, and not the account specified by the From element ([MS-ASEMAIL] section 2.2.2.36).
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.
Protocol version |
Element support, SendMail |
Element support, SmartForward |
Element support, SmartReply |
---|---|---|---|
2.5 |
|
|
|
12.0 |
|
|
|
12.1 |
|
|
|
14.0 |
|
|
|
14.1 |
Yes |
Yes |
Yes |
16.0 |
Yes |
Yes |
Yes |
16.1 |
Yes |
Yes |
Yes |