| |
 |
SWAPI_CountryIDToCountryName
This function retrieves the ISO 3166-1 country name by the country ID.
Syntax
| Microsoft Visual C++ |
DWORD __stdcall SWAPI_CountryIDToCountryName(
WORD CountryID,
PVOID DstBuff,
DWORD DstSize
); |
|
| Borland Delphi |
function SWAPI_CountryIDToCountryName(
const CountryID: WORD;
const DstBuff: Pointer;
const DstSize: DWORD
): DWORD; stdcall; |
|
| Microsoft Visual Basic |
Declare Function SWAPI_CountryIDToCountryName Lib "swapimap.dll" (
ByVal CountryID As Integer,
ByVal DstBuff As String,
ByVal DstSize As Long
) As Long |
|
Parameters
| CountryID |
[in] Country ID retrieved by using the functions for obtaining the country ID.
|
| DstBuff |
[out] Pointer to the buffer to receive the string containing the country name.
|
| DstSize |
| [in] Size of the buffer specified by the DstBuff parameter in bytes. This value should be set to 64 or greater. |
Return Value
If the function succeeds, the return value is non-zero. If the return value is greater than DstSize, the value returned is the size of DstBuff required to hold the name. Otherwise, the value returned is the length of the string copied to DstBuff.
If the function fails, the return value is zero.
Remarks
The terminating null character is not copied to the buffer specified by DstBuff. Use the function return value to determine the length of the string copied to DstBuff.
Sample Code
| Microsoft Visual C++ |
DWORD IPAddress;
WORD CountryID;
static CHAR result[65];
CString CountryName;
int i;
IPAddress = 69956104;
CountryID = SWAPI_IPAddressToCountryID(IPAddress, 0);
if (CountryID == 0) {
CountryName = "Unknown";
}
else {
i = SWAPI_CountryIDToCountryName(CountryID, result, 64);
result[i] = 0;
CountryName = result;
}
AfxMessageBox(CountryName); |
|
| Borland Delphi |
var
IPAddress: DWORD;
CountryID: WORD;
CountryName: string;
begin
IPAddress := 69956104;
CountryID := SWAPI_IPAddressToCountryID(IPAddress, 0);
if (CountryID = 0) then
CountryName := 'Unknown'
else
begin
SetLength(CountryName, 64);
SetLength(CountryName, SWAPI_CountryIDToCountryName(CountryID,
Pointer(CountryName), 64));
end;
ShowMessage(CountryName);
end; |
|
| Microsoft Visual Basic |
IPAddress = 69956104
CountryID = SWAPI_IPAddressToCountryID(IPAddress, 0)
if (CountryID = 0) then
CountryName = "Unknown"
else
res = Space$(65)
i = SWAPI_CountryIDToCountryName(CountryID, res, 64)
CountryName = Mid$(res, 1, i)
End if
MsgBox(CountryName) |
|
Defined In
| Microsoft Visual C++ |
| SWAPIMap.h, SWAPIMap.cpp |
|
| Borland Delphi |
| SWAPIMap.pas |
|
| Microsoft Visual Basic |
| SWAPIMap.bas |
|
See Also
Functions for Obtaining the Country ID
SWAPI_CountryIDToCountryCode
Copyright © 2006-2008, TamoSoft
|
