The SendMessage method is used to send a text message
to the specified mobile device. This control is designed to support
multiple methods of sending text messages, with the ServiceType
property determining how the message is sent:
smsServiceSmtp
This message service sends the message through the wireless service
provider's mail gateway using the SMTP protocol. However, it is
important to note that many of these gateways will not accept messages
from a client that is connected to them using a residential Internet
service provider. If the application is being run on a system that
uses a residential provider, that service provider may also block
outbound connections to all mail servers other than their own. These
anti-spam measures typically require that most end-user applications
specify a relay mail server rather than submitting the message
directly to the wireless provider's gateway.
By default, this method will attempt to automatically determine
which service provider is associated with the phone number. If the
service provider cannot be determined, this method will fail and
return an error code. If the Provider property has
been set to to the name of a specific service provider, that provider
will be used to determine the gateway email address.
Because most wireless carriers in the United States and Canada must
provide for wireless number portability, there is the possibility that
the provider information returned may no longer correspond to the
telephone number. It is recommended that you provide your end-user
with the ability to specify an alternate preferred provider to use
when sending the text message. For more information, refer to
ProviderCount and ProviderName properties.
This method sends an HTTP query to the server api.sockettools.com
to obtain information about the phone number and wireless service
provider. This requires that the local system can establish a standard
network connection over port 80. If the client cannot connect to the
server, the method will fail and an appropriate error will be returned.
The server imposes a limit on the maximum number of connections that
can be established and the maximum number of requests that can be
issued per minute. If this method is called multiple times over a short
period, the control may also force the application to block briefly.
Server responses are cached per session, so calling this method multiple
times using the same phone number will not increase the request count.