SharepointEmailWS.ModifyDistributionGroup Method

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

Namespace:  websvcSharepointDirectoryManagementService
Assembly:  STSSOAP (in STSSOAP.dll)

Syntax

<SoapDocumentMethodAttribute("http://microsoft.com/webservices/SharePoint/SharepointEmailWS/ModifyDistributionGroup", RequestNamespace := "http://microsoft.com/webservices/SharePoint/SharepointEmailWS/",  _
    ResponseNamespace := "http://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

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("http://microsoft.com/webservices/SharePoint/SharepointEmailWS/ModifyDistributionGroup", RequestNamespace = "http://microsoft.com/webservices/SharePoint/SharepointEmailWS/", 
    ResponseNamespace = "http://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: websvcSharepointDirectoryManagementService.RequestInfo
  An object containing information about the person who wants to change the information about the group and his or her reasons.

• Flags
  Type: websvcSharepointDirectoryManagementService.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: websvcSharepointDirectoryManagementService.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
)

See Also

Reference

SharepointEmailWS Class

SharepointEmailWS Members

websvcSharepointDirectoryManagementService Namespace