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

  • 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.)

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