SharepointEmailWS.ModifyDistributionGroup Method

Requests a change in the stored information about an e-mail distribution group.

Namespace:  [Sharepointemailws Web service]
Web service reference: http://Site/_vti_bin/Sharepointemailws.asmx

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://microsoft.com/webservices/SharePoint/SharepointEmailWS/ModifyDistributionGroup", RequestNamespace := "https://microsoft.com/webservices/SharePoint/SharepointEmailWS/",  _
    ResponseNamespace := "https://microsoft.com/webservices/SharePoint/SharepointEmailWS/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function ModifyDistributionGroup ( _
    Alias As String, _
    Name As String, _
    Description As String, _
    ContactCN As String, _
    Info As RequestInfo, _
    Flags As DistributionGroupFlags _
) As RequestResponse
'Usage
Dim instance As SharepointEmailWS
Dim Alias As String
Dim Name As String
Dim Description As String
Dim ContactCN As String
Dim Info As RequestInfo
Dim Flags As DistributionGroupFlags
Dim returnValue As RequestResponse

returnValue = instance.ModifyDistributionGroup(Alias, _
    Name, Description, ContactCN, Info, _
    Flags)

[SoapDocumentMethodAttribute("https://microsoft.com/webservices/SharePoint/SharepointEmailWS/ModifyDistributionGroup", RequestNamespace = "https://microsoft.com/webservices/SharePoint/SharepointEmailWS/", 
    ResponseNamespace = "https://microsoft.com/webservices/SharePoint/SharepointEmailWS/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public RequestResponse ModifyDistributionGroup(
    string Alias,
    string Name,
    string Description,
    string ContactCN,
    RequestInfo Info,
    DistributionGroupFlags Flags
)

Parameters

• Alias
  Type: System.String

  The e-mail alias of the group.

• Name
  Type: System.String

  The user-friendly name of the group. (This can be the same as the existing value or changed.)

• Description
  Type: System.String

  A description of the group. (This can be the same as the existing value or changed.)

• ContactCN
  Type: System.String

  The manager of the group. (This can be the same as the existing value or changed.)

• Info
  Type: [Sharepointemailws Web service].RequestInfo

  An object containing information about the person who wants to change the information about the group and his or her reasons.

• Flags
  Type: [Sharepointemailws Web service].DistributionGroupFlags

  A value indicating whether unauthenticated e-mail that is addressed to the group is deleted by Microsoft Exchange or sent to the group. (This can be the same as the existing value or changed.)

Return Value

Type: [Sharepointemailws Web service].RequestResponse
A RequestResponse value that provides information about the request.

Remarks

You cannot use ModifyDistributionGroup to request a change in the alias of a distribution group. You must use RenameDistributionGroup.

Examples

The following example shows how to call ModifyDistributionGroup.

Web_Reference_Folder_Name.SharePointEmailWS emailService = new Web_Reference_Folder_Name.SharePointEmailWS();

Web_Reference_Folder_Name.RequestInfo info = new Web_Reference_Folder_Name.RequestInfo();

info.Justification = "Group needs friendlier name.";
info.RequestorEmail = "bob@localExchangeServer.com";

Web_Reference_Folder_Name.RequestResponse outcome = new Web_Reference_Folder_Name.RequestResponse();

outcome = emailService.ModifyDistributionGroup(
                  "marketTeamLeaders",
                  "Leaders of the Marketing Team",
                  "All continental, national, and regional marketing 
                   leaders are in this group.",
                  "IntlMarketVP",
                  info,
                  Web_Reference_Folder_Name.DistributionGroupFlags.None
)

Dim emailService As New Web_Reference_Folder_Name.SharePointEmailWS()

Dim info As New Web_Reference_Folder_Name.RequestInfo()

info.Justification = "Group needs friendlier name."
info.RequestorEmail = "bob@localExchangeServer.com"

Dim outcome As New Web_Reference_Folder_Name.RequestResponse()

 outcome = emailService.ModifyDistributionGroup("marketTeamLeaders",
                         "Leaders of the Marketing Team", 
                        "All continental, national, and regional marketing leaders are in this group.", 
                        "IntlMarketVP", info, Web_Reference_Folder_Name.DistributionGroupFlags.None)

See Also

Reference

SharepointEmailWS Class

SharepointEmailWS Members

Sharepointemailws Web Service