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를 호출합니다.
| 반환 코드 | 설명 |
|---|---|
|
제공된 버퍼 크기가 충분히 크지 않거나 NULL로 잘못 설정되었습니다. |
|
매개 변수 값이 잘못되었습니다. |
|
플래그에 제공된 값이 잘못되었습니다. |
설명
두 글자 ISO 3166-1 코드에 대한 자세한 내용은 국가 코드 - ISO 3166을 참조하세요. 숫자 UN M.49 코드에 대한 자세한 내용은 통계 사용에 대한 표준 국가 또는 지역 코드(M49)를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winnls.h |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |