EnumSystemGeoNames function

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

Enumerates the two-letter International Organization for Standardization (ISO) 3166-1 codes or numeric United Nations (UN) Series M, Number 49 (M.49) codes for geographical locations that are available on the operating system.

Syntax


BOOL WINAPI EnumSystemGeoNames(
  _In_     GEOCLASS         geoClass,
  _In_     GEO_ENUMNAMEPROC geoEnumProc,
  _In_opt_ LPARAM           data
);

Parameters

geoClass [in]

The geographical location class for which to enumerate the available two-letter ISO 3166-1 or numeric UN M.49 codes.

geoEnumProc [in]

Pointer to the application-defined callback function Geo_EnumNameProc. The EnumSystemGeoNames function calls this callback function for each of the two-letter ISO 3166-1 or numeric UN M.49 codes for geographical locations that are available on the operating system until callback function returns FALSE.

data [in, optional]

Application-specific information to pass to the callback function that the genEnumProc parameter specifies.

Return value

Returns a nonzero value if successful, or 0 otherwise. To get extended error information, call GetLastError, which can return one of the following error codes:

Return codeDescription
ERROR_INVALID_FLAGS

The values supplied for flags were not valid.

ERROR_INVALID_PARAMETER

A parameter value was not valid.

 

Remarks

For information about two-letter ISO 3166-1 codes, see Country Codes - ISO 3166. For information about numeric UN M.49 codes, see Standard country or area codes for statistical use (M49).

Requirements

Minimum supported client

Windows 10, version 1709 [desktop apps only]

Minimum supported server

Windows Server 2016 [desktop apps only]

Header

Winnls.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

National Language Support
National Language Support Functions
Geo_EnumNameProc
EnumSystemGeoID

 

 

Show: