LocationServiceSoap.DeleteContact Method

Deletes the specified contact entry from the list of contacts for the current user.

Public Sub DeleteContact (domainAlias As System.String)

[C#]
public DeleteContact (System.String domainAlias);

Parameters

• domainAlias
  The domain and alias of the contact that is being deleted from the contact list, in the format "domain\user". The domainAlias parameter is required and must be passed as a string. For information about the maximum length of the domainAlias argument, see MapPoint Location Server Parameter Lengths.

Remarks

This method accepts the following SOAP headers:

UserInfoLocationHeader—Used to establish the current user's (the user that is invoking the location service) specific information, such as culture and so on. When this SOAP header is not provided, the current user's default culture is applied. For more information, see UserInfoLocationHeader Class.

ClientIdHeader—Not used with MapPoint Location Server 1.0.

If the user specified by the domain and alias string cannot be found in the MapPoint Location Server system, a UserNotProvisionedException exception is thrown.

If the domain and alias of the user is the same as the value of the domainAlias parameter, a CallerSameAsContactException exception is thrown.

Because this is a Web service, all exceptions appear as SOAP exceptions. For more information, see the SoapException.Detail property.

Example

 
[Visual Basic]
    'Create a LocationServiceSoap proxy instance.
    Dim MyLocationService As New LocationServiceSoap
    'Create and add the credentials required to access the Web service.
    Dim MyCredentials As New NetworkCredential("user", "password", "DOMAIN")
    MyLocationService.Credentials = MyCredentials

    Try
        'Delete the contact
        MyLocationService.DeleteContact("DOMAIN\contactuser")

    Catch MyException As SoapException
        'Your exception processing goes here.
        If ((Not MyException.Detail Is Nothing) And (Not MyException.Detail("Type") Is Nothing)) Then
            MessageBox.Show(MyException.Detail("Type").InnerText)
        End If

    Finally
        'Your cleanup goes here
        MyLocationService = Nothing
    End Try


 
[C#]
  //Create a LocationServiceSoap proxy instance.
  LocationServiceSoap MyLocationService = new LocationServiceSoap();
  //Create and add the credentials required to access the Web service.
  NetworkCredential MyCredentials = new NetworkCredential("user", "password", "DOMAIN");
  MyLocationService.Credentials = MyCredentials;

  try
  {
   //Delete the contact
   MyLocationService.DeleteContact(@"DOMAIN\contactuser");
  }
  catch(SoapException MyException)
  {
   //Your exception processing goes here.
   if (MyException.Detail != null && MyException.Detail["Type"] != null)
    MessageBox.Show(MyException.Detail["Type"].InnerText);
  }
  finally
  {
   //Your cleanup goes here
   MyLocationService = null;
  }  

  
 

See Also

Location Service Class  |  UserInfoLocationHeader Class  |  Contact Definition  |  Using Soap Headers