GetGeoInfoEx 함수(winnls.h)

아티클
03/13/2024

ISO(국제 표준화 기구) 3166-1 코드 또는 숫자 UN(UN) 시리즈 M, 번호 49(M.49) 코드를 사용하여 지정한 지리적 위치에 대한 정보를 검색합니다.

구문

int GetGeoInfoEx(
  [in]            PWSTR   location,
  [in]            GEOTYPE geoType,
  [out, optional] PWSTR   geoData,
  [in]            int     geoDataCount
);

매개 변수

[in] location

정보를 가져올 지리적 위치에 대한 두 글자 ISO 3166-1 또는 숫자 UN M.49 코드입니다. 운영 체제에서 사용할 수 있는 코드를 얻으려면 EnumSystemGeoNames를 호출합니다.

[in] geoType

검색할 정보의 유형입니다. 가능한 값은 SYSGEOTYPE 열거형으로 정의됩니다. SYSGEOTYPE 열거형의 다음 값은 GetGeoInfoEx와 함께 사용하면 안 됩니다.

GEO_ID
이 값은 이전 버전과의 호환성을 위해 제공됩니다. 새 애플리케이션에서 이 값을 사용하지 말고 대신 GEO_NAME 사용합니다.
GEO_LCID
GetGeoInfoEx 함수에는 이 값이 지원되지 않습니다.
GEO_NATION
GetGeoInfoEx 함수에는 이 값이 지원되지 않습니다.
GEO_RFC1766
GetGeoInfoEx 함수에는 이 값이 지원되지 않습니다.

[out, optional] geoData

GetGeoInfoEx에서 요청된 정보를 작성해야 하는 버퍼에 대한 포인터입니다.

[in] geoDataCount

GeoData 매개 변수가 가리키는 버퍼의 크기(문자)입니다. 이 매개 변수를 0으로 설정하여 함수가 요청된 정보를 버퍼에 쓰지 않고 요청된 정보를 저장하는 데 필요한 버퍼 크기만 반환하도록 지정합니다.

반환 값

함수가 출력 버퍼를 작성한 지리적 위치 정보의 바이트 수입니다. geoDataCount가 0이면 함수는 버퍼에 정보를 쓰지 않고 정보를 보유하는 데 필요한 버퍼의 크기를 반환합니다.

0은 함수가 성공하지 못했음을 나타냅니다. 확장 오류 정보를 얻으려면 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출합니다.

반환 코드	설명
ERROR_INSUFFICIENT_BUFFER	제공된 버퍼 크기가 충분히 크지 않거나 NULL로 잘못 설정되었습니다.
ERROR_INVALID_PARAMETER	매개 변수 값이 잘못되었습니다.
ERROR_INVALID_FLAGS	플래그에 제공된 값이 잘못되었습니다.

설명

두 글자 ISO 3166-1 코드에 대한 자세한 내용은 국가 코드 - ISO 3166을 참조하세요. 숫자 UN M.49 코드에 대한 자세한 내용은 통계 사용에 대한 표준 국가 또는 지역 코드(M49)를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winnls.h
라이브러리	Kernel32.lib
DLL	Kernel32.dll