SetEmailConfiguration Method (WMI MSReportServer_ConfigurationSetting Class)

Configures the e-mail delivery extension used by the report server to send e-mail.

Syntax

Public Sub SetEmailConfiguration(SMTPServer as String,_
    SendUsingSMTPServer as Boolean, SenderEmailAddress as String,_
    ByRef HRESULT as Int32)
public void SetEmailConfiguration (string SMTPServer, 
   SendUsingSMTPServer as string, SenderEmailAddress as string, 
   out sint32 HRESULT);

Parameters

  • SMTPServer
    A string containing the name or IP address of an SMTP server.
  • SendUsingSMTPServer
    A Boolean value indicating whether the server is to use the SMTP server to send email. This value can only be set to true.
  • SenderEmailAddress
    The e-mail address used in the 'From:' field for e-mails sent from the report server.
  • HRESULT
    [out] Value indicating whether the call succeeded or failed.

Return Value

Returns an HRESULT indicating success or failure of the method call. A value of 0 indicates that the method call was successful. A non-zero value indicates that an error has occurred.

Remarks

When the SendUsingSMTPServer parameter is set to true, the SendUsing entry in the report server configuration file is set to 1. When SendUsingSMTPServer is set to false, the SendUsing entry is not configured.

This method does not provide a way for users to set the SendUsing entry in the report server configuration file to a value other than 1. To configure the report server for anything other than SMTP mail, you must edit the configuration file manually.

Requirements

Namespace:root\Microsoft\SqlServer\ReportServer\v9\Admin

Platform: Windows Server 2003, Datacenter Edition; Windows Server 2003, Enterprise Edition; Windows Server 2003, Standard Edition; Windows Vista; Windows XP Professional with Service Pack 2 (SP2) or Service Pack 1 (SP1); or Windows 2000 (all versions)

See Also

Reference

MSReportServer_ConfigurationSetting Members
MSReportServer_ConfigurationSettingForSharePoint Members

Help and Information

Getting SQL Server 2005 Assistance