| |
This structure contains information about a wireless service
provider.
typedef struct _SMSPROVIDER
{
INT nProviderId;
INT nCountryCode;
INT nRegionCode;
INT nMessageLength;
DWORD dwFlags;
DWORD dwReserved;
TCHAR szGuid[SMS_MAXPROVIDERGUIDLEN];
TCHAR szName[SMS_MAXPROVIDERNAMELEN];
TCHAR szCompany[SMS_MAXCOMPANYNAMELEN];
TCHAR szDomain[SMS_MAXDOMAINNAMELEN];
} SMSPROVIDER, *LPSMSPROVIDER;
Members
- nProviderId
- An integer value which identifies the provider record. This
value is used internally and an application should not depend on
the value not changing over time for a specific service provider.
To uniquely identify a provider, use the szGuid member of
the structure, which is guaranteed not to change as providers are
added and removed from the database.
- 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.
- nRegionCode
- An integer value which identifies the region that the service
provider covers. In North America, each region consists of multiple
states and/or provinces. If a provider services multiple regions,
this will identify the primary region where they provide
coverage.
| Value |
Description |
SMS_REGION_NATIONAL
0 |
All regions. This region code is used for service providers
that have national coverage and do not exclusively provide
service within one or more specific geographical regions. |
SMS_REGION_NORTH_EAST_ATLANTIC
1 |
Northeastern Atlantic region which includes Connecticut,
Maine, Massachusetts, New Hampshire, New Brunswick,
Newfoundland, Nova Scotia, Rhode Island and Vermont. |
SMS_REGION_MIDDLE_ATLANTIC
2 |
Middle Atlantic region which includes New Jersey, New York,
Delaware, District of Columbia, Maryland, Pennsylvania, Quebec,
Virginia and West Virginia. |
SMS_REGION_EAST_NORTH_CENTRAL
3 |
Northeastern central region which includes Illinois,
Indiana, Michigan, Ohio and Wisconsin. |
SMS_REGION_SOUTH_ATLANTIC
4 |
Southern Atlantic region which includes Florida, Georgia,
North Carolina and South Carolina. |
SMS_REGION_EAST_SOUTH_CENTRAL
5 |
Southeastern central region which includes Alabama,
Kentucky, Mississippi and Tennessee. |
SMS_REGION_WEST_NORTH_CENTRAL
6 |
Northwestern central region which includes Iowa, Kansas,
Manitoba, Minnesota, Missouri, Nebraska, North Dakota, Ontario
and South Dakota. |
SMS_REGION_WEST_SOUTH_CENTRAL
7 |
Southwestern central region which includes Arkansas,
Louisiana, Oklahoma and Texas. |
SMS_REGION_MOUNTAIN
8 |
Mountain region which includes Alberta, Arizona, Colorado,
Idaho, Montana, Nevada, New Mexico, Northwest Territories,
Saskatchewan, Utah and Wyoming. |
SMS_REGION_PACIFIC
9 |
Pacific region which includes Alaska, British Columbia,
California, Hawaii, Oregon, Washington and Yukon. |
- 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.
- dwFlags
- An unsigned integer value which specifies one or more flags
that provides additional information about the service provider. This
value is constructed by using a bitwise operator with any of the
following constants:
| Value |
Description |
SMS_PROVIDER_DEFAULT
0 |
A standard service provider. Typically this means that
customers have a service contract for their mobile device and
pay monthly access and service charges. |
SMS_PROVIDER_PREPAID
1 |
A service provider that offers pre-paid calling cards or
fixed month-to-month payments that do not require long-term
service contracts. |
- dwReserved
- A value reserved for internal use.
- szGuid
- A pointer to a string which uniquely identifies the service
provider. The string is in a standard format used for globally
unique identifiers (GUIDs) and is guaranteed to not change for the
service provider it has been assigned to.
- szName
- A pointer to a string which specifies the name of service
provider. Note that this value may not represent the actual company
that is providing the wireless service.
- szCompany
- A pointer to a string which specifies the name of the
company associated with the service provider. This may be the same
as name of the service provider itself or it may be the name of a
parent company that owns the service provider.
- 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.
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
|
|