Skip to content

Latest commit

 

History

History
168 lines (123 loc) · 4.88 KB

nf-winnls-getgeoinfoex.md

File metadata and controls

168 lines (123 loc) · 4.88 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winnls.GetGeoInfoEx
GetGeoInfoEx function (winnls.h)
Retrieves information about a geographic location that you specify by using a two-letter International Organization for Standardization (ISO) 3166-1 code or numeric United Nations (UN) Series M, Number 49 (M.49) code.
GetGeoInfoEx
GetGeoInfoEx function [Internationalization for Windows Applications]
intl.getgeoinfoex
winnls/GetGeoInfoEx
intl\getgeoinfoex.htm
Intl
05BF6434-A80F-4BF5-9A43-C4D65E72F43B
12/05/2018
GetGeoInfoEx, GetGeoInfoEx function [Internationalization for Windows Applications], intl.getgeoinfoex, winnls/GetGeoInfoEx
winnls.h
Windows
Windows 10, version 1709 [desktop apps only]
Windows Server 2016 [desktop apps only]
Kernel32.lib
Kernel32.dll
Windows
19H1
GetGeoInfoEx
winnls/GetGeoInfoEx
c++
APIRef
kbSyntax
DllExport
Kernel32.dll
GetGeoInfoEx

GetGeoInfoEx function

-description

Retrieves information about a geographic location that you specify by using a two-letter International Organization for Standardization (ISO) 3166-1 code or numeric United Nations (UN) Series M, Number 49 (M.49) code.

-parameters

-param location [in]

The two-letter ISO 3166-1 or numeric UN M.49 code for the geographic location for which to get information. To get the codes that are available on the operating system, call EnumSystemGeoNames.

-param geoType [in]

The type of information you want to retrieve. Possible values are defined by the SYSGEOTYPE enumeration. The following values of the SYSGEOTYPE enumeration should not be used with GetGeoInfoEx:

  • GEO_ID

    This value is provided for backward compatibility. Do not use this value in new applications, but use GEO_NAME instead.

  • GEO_LCID

    This value is not supported for the GetGeoInfoEx function.

  • GEO_NATION

    This value is not supported for the GetGeoInfoEx function.

  • GEO_RFC1766

    This value is not supported for the GetGeoInfoEx function.

-param geoData [out, optional]

A pointer to the buffer in which GetGeoInfoEx should write the requested information.

-param geoDataCount [in]

The size of the buffer to which the GeoData parameter points, in characters. Set this parameter to 0 to specify that the function should only return the size of the buffer required to store the requested information without writing the requested information to the buffer.

-returns

The number of bytes of geographical location information that the function wrote the output buffer. If geoDataCount is 0, the function returns the size of the buffer required to hold the information without writing the information to the buffer.

0 indicates that the function did not succeed. To get extended error information, call GetLastError, which can return one of the following error codes:

Return code Description
ERROR_INSUFFICIENT_BUFFER
 The supplied buffer size was not large enough, or it was incorrectly set to NULL.
ERROR_INVALID_PARAMETER
 A parameter value was not valid.
ERROR_INVALID_FLAGS
 The values supplied for flags were 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).

-see-also

EnumSystemGeoNames

GetGeoInfo

National Language Support

National Language Support Functions

SYSGEOTYPE