3.2.4.2.5.5 MailTo (get) (Opnum 16)

The MailTo (get) method returns the mail to property of the action. The mailTo parameter value is the list of email addresses to which the email generated by this action will be sent. The format of the email address has to be as specified in [RFC5322].

 [propget, id(FSRM_PROPERTY(FSRM_DISPID_ACTION_EMAIL | 0x03))] HRESULT MailTo(
   [out, retval] BSTR* mailTo
 );

mailTo: Pointer to a variable that upon completion contains the email recipient list to which the email generated by this action will be sent. The string returned in mailTo MUST be in the form of a mailTo string (section 3.2.4.2).

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80070057

E_INVALIDARG

The mailTo parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

  • Verify that mailTo is not NULL.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

The server MUST set mailTo to the mail to list of email addresses of the action.

If the list of email recipients contains the special string "[ADMIN_EMAIL]", the server MUST return the list of email recipients without resolving the "[ADMIN _EMAIL]" macro.