function fetches the stored dialing rules and other information related to a
specified country, the first country in the country list, or all countries.
| DWORD dwCountryID,
| DWORD dwAPIVersion,
| LPLINECOUNTRYLIST lpLineCountryList
The country ID (not
the country code) of the country for which information is to be obtained. If
the value 1 is specified, information on the first country in the country list
is obtained. If the value 0 is specified, information on all countries is
obtained (which may require a great deal of memory
20Kbytes or more).
The highest version of TAPI supported by the application (not
necessarily the value negotiated by lineNegotiateAPIVersion
on some particular line device).
A pointer to a location to which a LINECOUNTRYLIST
structure will be loaded. Prior to calling lineGetCountry
, the application should set the dwTotalSize
field of this structure to indicate the amount of memory available to TAPI
for returning information.
Returns zero if the request is successful or a negative error number if an
error has occurred. Possible return values are:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT,
LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_STRUCTURETOOSMALL,
Although this is a new function which older applications would not be expected
to call, for backward compatibility, they should not be prevented from doing
so. The function will work the same way for all applications.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages