Microsoft MapPoint Location Server Exceptions Reference Introduction

This section contains reference documentation for the public exception types thrown by the MapPoint Location Server management API.

In this section

ActiveDirectoryDomainAliasException	Thrown when an error occurs while the Microsoft® Active Directory® values for a given domain and alias are being retrieved or read.
ActiveDirectorySearchErrorException	Thrown if a Microsoft® Active Directory® search fails to locate the specified user's domain and alias.
ActiveDirectoryServerNotOperationalException	Thrown by the methods that involve Microsoft® Active Directory® operations (such as provisioning a new user, and so on) when the Active Directory server is not operational.
CallerSameAsContactException	Thrown when the domain and alias of the user and the domain and alias of the contact are identical.
ContactNotFoundException	Thrown when the domain and alias of a contact is not found in MapPoint Location Server.
ContactRelationshipAlreadyExistsException	Thrown when a contact relationship exists between a provisioned user and a new contact, and an attempt is made to add the relationship to the contact list.
DatabaseAndServerVersionException	Thrown when an invalid database was configured for the MapPoint Location Server API.
DefaultCultureNotFoundException	Thrown when there is no Find Nearby category name (represented by the class FindNearbyCategoryName) matching the default culture of the Find Nearby category.
DuplicateCategoryNameCultureException	Thrown when an attempt is made to add a Find Nearby category that has duplicate FindNearbyCategoryName objects. There can only be one FindNearbyCategoryName object for each culture for a Find Nearby category.
FindNearbyCategoryAlreadyExistsException	Trown when a an attempt is made to add a Find Nearby category that already exists.
FindNearbyCategoryNotFoundException	Thrown when a specified Find Nearby category is not found.
FindMaxResultsExceededException	Thrown when the number of matches for the FindProvisionedUser method exceeds the number specified by the maxResult parameter.
UserAlreadyProvisionedException	Thrown when an attempt is made to add a user that is already provisioned.
InvalidContactStatusException	Thrown when an invalid status is set when a contact is managed through the AddContact or UpdateContact method.
InvalidCultureNameException	Thrown when a culture name is not valid.
InvalidDomainAliasException	Thrown when an invalid domain name is passed as an argument. The domain and alias must be in the format "domain\user".
InvalidMLSDatabaseException	Thrown if the target database does not appear to be a valid Microsoft MapPoint Location Server database.
LocatablePhoneNumberAlreadyProvisionedException	Thrown when an attempt is made to provision a phone number (locatable device) that is already provisioned.
NeutralCultureNameException	Thrown when a neutral culture (for example, "en") is passed and a specific culture (for example, "en-US") is expected.
NoContactRelationshipExistsException	Thrown when an attempt is made to update a contact relationship between two users and no contact relationship exists.
NoExactMatchOnDomainAliasException	Thrown by the user-management methods (AddUser, UpdateUser, and DeleteUser) when if no user is found that matches the domain and alias that are passed to the methods.
NoFindCriteriaException	Thrown when a call is made to the FindProvisionedUser method with no search criteria specified.
NotAValidNumberException	Thrown when a string that is expected to contain numeric characters contains other characters.
NumberAllowedContactsExceededException	Thrown when an attempt is made to add more than the maximum number of contacts for a provisioned user.
SelfReferentialContactException	Thrown when a user's domain and alias is the same as the contact's domain and alias.
ServerAPIException	Represents the exceptions that are thrown during various Microsoft MapPoint Location Server operations under unusual or unexpected circumstances such as network failure, sudden unavailability of the Microsoft MapPoint Location Server database, and so on.
SqlConnectionFailedException	Thrown if the ServerAPI class initialization method call fails to open a connection to the MapPoint Location Server database.
UninitializedServerAPIException	Thrown if a method of the ServerAPI class is called before the Initialize method has been called.
UserNotProvisionedException	Thrown by methods for managing provisioned users (such as UpdateUser, and so on), if a specified user does not exist in the MapPoint Location Server system.