AddBCC (Email subroutine): Difference between revisions
Jump to navigation
Jump to search
m (Created page with "This callable method allows you to add an SMTP mail recipient to the SMTP request that is sent to the server. ==AddBcc syntax== <p class="pre"> %email:AddBcc(name, [nickname]) </...") |
m (Created page with "This callable method allows you to add an SMTP mail recipient to the SMTP request that is sent to the server. ==AddBcc syntax== <p class="pre"> %email:AddBcc(name, [nickname]) </...") |
||
| Line 1: | Line 1: | ||
{{Template:Email:AddBCC subtitle}} | |||
This callable method allows you to add an SMTP mail recipient | This callable method allows you to add an SMTP mail recipient | ||
to the SMTP request that is sent to the server. | to the SMTP request that is sent to the server. | ||
== | ==Syntax== | ||
{{Template:Email:AddBCC syntax}} | |||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
| Line 23: | Line 23: | ||
</td></tr></table> | </td></tr></table> | ||
==Usage | ==Usage notes== | ||
<ul> | <ul> | ||
<li>Mail servers should be able to accept as many as 100 or more distinct | <li>Mail servers should be able to accept as many as 100 or more distinct | ||
| Line 31: | Line 31: | ||
<var>[[AddCc (Email function)|AddCc]]</var>, and <var>AddRecipient</var> methods. | <var>[[AddCc (Email function)|AddCc]]</var>, and <var>AddRecipient</var> methods. | ||
<li>Recipients added with the <var>AddBcc</var> method do not appear in either | <li>Recipients added with the <var>AddBcc</var> method do not appear in either | ||
the “To:” or “Cc:” headers in the e-mail message. | the &ldquo;To:&rdquo; or &ldquo;Cc:&rdquo; headers in the e-mail message. | ||
<li>The optional ''nickname'' parameter is provided only for | <li>The optional ''nickname'' parameter is provided only for | ||
compatibility with the <var>AddRecipient</var> and <var>Mail</var> methods. | compatibility with the <var>AddRecipient</var> and <var>Mail</var> methods. | ||
| Line 37: | Line 37: | ||
<li>For an example that includes this method, see [[SMTP Helper#Basic e-mail|"Basic e-mail"]]. | <li>For an example that includes this method, see [[SMTP Helper#Basic e-mail|"Basic e-mail"]]. | ||
</ul> | </ul> | ||
==See also== | |||
{{Template:Email:AddBCC footer}} | |||
Revision as of 21:41, 5 July 2011
Add a BCCd mail recipient (Email class)
This callable method allows you to add an SMTP mail recipient
to the SMTP request that is sent to the server.
Syntax
email:AddBCC( name, [nickname])
Syntax terms
| A previously declared Email object. | |
| name | A string expression that contains an email address:
a userid, followed by an at sign (@), followed by a domain name. |
| nickname | An optional string expression that contains a familiar name associated
with the e-mail address. For AddBcc, this parameter is superfluous, but it is provided for compatibility with AddRecipient and Mail. |
Usage notes
- Mail servers should be able to accept as many as 100 or more distinct recipients for a single mail message, though stricter limits may be imposed by some mail servers. The recipient count is the sum of all e-mail addresses added with the AddBcc, AddCc, and AddRecipient methods.
- Recipients added with the AddBcc method do not appear in either the “To:” or “Cc:” headers in the e-mail message.
- The optional nickname parameter is provided only for compatibility with the AddRecipient and Mail methods. It is not sent as part of the e-mail message.
- For an example that includes this method, see "Basic e-mail".