| |
This structure contains information about a text message gateway
server and the recipient.
typedef struct _SMSGATEWAY
{
INT nGatewayId;
INT nCountryCode;
INT nAreaCode;
INT nExchange;
INT nMessageLength;
DWORD dwReserved;
TCHAR szProvider[SMS_MAXPROVIDERNAMELEN];
TCHAR szDomain[SMS_MAXDOMAINNAMELEN];
TCHAR szServer[SMS_MAXMAILSERVERLEN];
TCHAR szAddress[SMS_MAXMAILADDRESSLEN];
} SMSCHANNEL, *LPSMSCHANNEL;
Members
- nGatewayId
- An integer value which identifies the gateway record. This
value is used internally and an application should not depend on
the value not changing over time for a specific telephone number.
As new area codes are introduced, the provider database will be
updated to reflect these changes and that can result in a change to
the gateway ID associated with a specific telephone number.
- nCountryCode
- An integer value which specifies the ITU country calling code
associated with the service provider. Currently this value will
always be 1, which is the country code used by North American
service providers. If the service provider database is expanded to
include additional countries in the future, this value will
identify the country of origin.
- nAreaCode
- An integer value which specifies the Numbering Plan Area (NPA)
code, commonly known as the area code. For the United States and
Canada, area codes are assigned by the North American Numbering
Plan Administration (NANPA). In North America, the area code is
digits 1-3 for a 10-digit telephone number. This value, along with
the exchange, is used to determine which company provides wireless
service for a specific telephone number.
- nExchange
- An integer value which specifies the exchange area. In North
America, the exchange is digits 4-6 for a 10-digit telephone
number. This value, along with the area code, is used to determine
which company provides wireless service for a specific telephone
number.
- nMessageLength
- An integer value which specifies the maximum number of
characters that the service provider will accept for a single text
message. If the message exceeds this number of characters, the
service provider may reject the message, or it may split the
message into multiple messages.
- dwReserved
- A value reserved for internal use.
- szProvider
- A pointer to a string which identifies the name of the
service provider that is associated with the specified telephone
number. Note that this value may not represent the actual company
that is providing the wireless service.
- szDomain
- A pointer to a string which identifies the gateway domain
name used by the service provider to accept text messages for their
customer. This domain name is used to determine the actual name of
the gateway mail server that is responsible for accepting
messages.
- szServer
- A pointer to a string which identifies the host name or IP
address of the mail server used to accept text messages for the
specified service provider. In some cases, a provider may have
multiple gateway servers and this value will represent the
preferred mail server for the domain.
- szAddress
- A pointer to a string which contains the complete email
address that should be used when sending the text message through
the gateway mail server. Different service providers can have
slightly different rules about how the address is formatted, but it
typically is a combination of the telephone number and the gateway
domain name.
Requirements
Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cstools11.h
Unicode: Implemented as Unicode and ANSI versions
|
|