3.2.4.2.5.12 MailSubject (put) (Opnum 23)

  • Article

The MailSubject (put) method sets the mail subject property of the action. The mailSubject string parameter value will be used as the subject line of email generated by this action.

 [propput, id(FSRM_PROPERTY (FSRM_DISPID_ACTION_EMAIL | 0x06))] HRESULT MailSubject(
   [in] BSTR mailSubject
 );

mailSubject: Contains the subject to use for this action.

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

Return value/code

Description

0x8004530D

FSRM_E_OUT_OF_RANGE

The content of the mailSubject parameter exceeds the maximum length of 4,000 characters.

0x80070057

E_INVALIDARG

The mailSubject parameter is NULL.

The server MUST use mailSubject as the subject of email generated by this action or return a nonzero error code.

The mailSubject can contain macros (section 3.2.4.3). If the mailSubject contains macros (section 3.2.4.3), the server MUST store mailSubject as provided, keeping the macros instead of resolving the macros with the values they resolve to. The server MUST allow all macros from section 3.2.4.3. The macros are resolved when the email for this notification is generated.

The server MUST NOT alter the stored mail subject of the action when the macros are resolved. The mail subject with the resolved macro values is only used for the subject of the email being generated.