Share via

BizTeam.ChangeName Method

  • Article

The ChangeName method changes the name of a team.

Syntax

[Visual Basic .NET]
Public Sub ChangeName(
  ByVal Caller As CUserAuth,
  ByVal TeamId As String,
  ByVal NewName As String
)
[C#]
public void ChangeName(
  CUserAuth  Caller,
  string  TeamId,
  string  NewName
);
[C++]
public: void ChangeName(
  CUserAuth*  Caller,
  String*  TeamId,
  String*  NewName
);

Parameters

Caller

Specifies the identity of the caller. The caller must have the prvWriteTeam privilege to perform this action. See CUserAuth.

TeamId

Specifies the ID of the team.

NewName

Specifies a new name for the team.

Return Value

No return value.

Remarks

If there is an error, SOAP throws an exception and the error message is reported in System.Web.Services.Protocols.SoapException.Detail.OuterXml.

All IDs passed to the platform are GUIDs wrapped in braces. For example: {6522D89A-A752-4455-A2B0-51494C6957C3}

Example

[C#]
// strServer should be set with the name of the platform Web server
string strServer = "myservername";

// strVirtualDirectory should be set with the name of the Microsoft CRM 
// virtual directory on the platform Web server
string strVirtualDirectory = "mscrmservices";

// Create the URL to the SRF files for platform objects
string strDir = "https://" + strServer + "/" + strVirtualDirectory + "/";

// BizUser proxy object
Microsoft.CRM.Proxy.BizUser user = new Microsoft.CRM.Proxy.BizUser ();
user.Credentials = System.Net.CredentialCache.DefaultCredentials;
user.Url = strDir + "BizUser.srf";

// BizTeam proxy object
Microsoft.CRM.Proxy.BizTeam team = new Microsoft.CRM.Proxy.BizTeam ();
team.Credentials = System.Net.CredentialCache.DefaultCredentials;
team.Url = strDir + "BizTeam.srf";

// Declare the caller
Microsoft.CRM.Proxy.CUserAuth userAuth = null;

string strErrorMsg;
string strTeamID = "{GCF99EF1-67IO-4E06-ABD9-EBFE526BF9FF}";
try
{
   // Get the UserAuth of the current logged-on user
   userAuth = user.WhoAmI();

   team.ChangeName(userAuth, strTeamID, "The Yellow Team");
}
catch(System.Web.Services.Protocols.SoapException err)
{
   // Process the platform error here
   strErrorMsg = ("ErrorMessage: " + err.Message + " " + err.Detail.OuterXml + " Source: " + err.Source );
}
catch(Exception err)
{
   // Process other errors here
   strErrorMsg = ("ErrorMessage: " + err.Message + "Source: " + err.Source );
}

Requirements

Namespace: Microsoft.CRM.Proxy

Assembly: microsoft.crm.proxy.dll

See Also

© 2003 Microsoft Corporation. All rights reserved.