다음을 통해 공유


GetGeoInfoEx 함수(winnls.h)

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

참고 항목

EnumSystemGeoNames

GetGeoInfo

국가 언어 지원

국가 언어 지원 기능

SYSGEOTYPE