GetGeoInfoA 함수(winnls.h)

[GetGeoInfo 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 사용할 수 없습니다. 대신 GetGeoInfoEx사용합니다.

]

지정된 지리적 위치에 대한 정보를 검색합니다.

통사론

int GetGeoInfoA(
  [in]            GEOID   Location,
  [in]            GEOTYPE GeoType,
  [out, optional] LPSTR   lpGeoData,
  [in]            int     cchData,
  [in]            LANGID  LangId
);

매개 변수

[in] Location

정보를 가져올 지리적 위치에 대한 식별자입니다. 자세한 내용은 지리적 위치표를 참조하세요. EnumSystemGeoID호출하여 사용 가능한 값을 가져올 수 있습니다.

[in] GeoType

검색할 정보의 유형입니다. 가능한 값은 SYSGEOTYPE 열거형으로 정의됩니다. GeoType 값이 GEO_LCID 경우 함수는 로캘 식별자를 검색합니다. GeoType 값이 GEO_RFC1766 경우 함수는 RFC 4646(Windows Vista)을 준수하는 문자열 이름을 검색합니다. 자세한 내용은 설명 섹션을 참조하세요.

Windows XP:GeoType GEO_LCID 설정된 경우 검색된 문자열은 8자리 16진수 값입니다.

Windows Me:GeoType GEO_LCID 설정된 경우 검색된 문자열은 10진수 값입니다.

[out, optional] lpGeoData

이 함수가 정보를 검색하는 버퍼에 대한 포인터입니다.

[in] cchData

lpGeoData표시된 버퍼의 크기입니다. 크기는 함수의 ANSI 버전에 대한 바이트 수 또는 유니코드 버전의 단어 수입니다. 함수가 버퍼의 필요한 크기를 반환하는 경우 애플리케이션에서 이 매개 변수를 0으로 설정할 수 있습니다.

[in] LangId

위치값과 함께 사용되는 언어의 식별자입니다. 애플리케이션은 GeoType대해 지정된 GEO_RFC1766 또는 GEO_LCID 사용하여 이 매개 변수를 0으로 설정할 수 있습니다. 이 설정으로 인해 함수는 GetUserDefaultLangID호출하여 언어 식별자를 검색합니다.

반환 값

출력 버퍼에서 검색된 지리적 위치 정보의 ANSI(바이트 수) 또는 단어(유니코드)를 반환합니다. cchData 0으로 설정된 경우 함수는 버퍼에 필요한 크기를 반환합니다.

함수가 성공하지 못하면 0을 반환합니다. 확장 오류 정보를 가져오기 위해 애플리케이션은 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError호출할 수 있습니다.

• ERROR_INSUFFICIENT_BUFFER. 제공된 버퍼 크기가 충분히 크지 않거나 NULL잘못 설정되었습니다.
• ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

발언

애플리케이션에서 GeoType대한 GEO_RFC1766 지정하는 경우 지정된 지리적 위치 식별자에 적합한 LangId 언어 식별자를 지정해야 합니다. 적절한 언어는 로캘 중립적 언어이거나 지정된 식별자에 해당하는 로캘이 있는 언어입니다. RFC 4646(Windows Vista)을 준수하는 결과 문자열은 로캘 이름구성합니다.

예를 들어 위치 미국의 0xF4 지정되는 경우 GeoType GEO_RFC1766 지정되고 LangId 로캘 중립적 영어의 0x09 또는 영어(미국)의 0x409 반환 시 "en-US"를 검색합니다. 실제로 함수는 언어의 로캘 관련 부분을 무시합니다. 따라서 애플리케이션에서 LangId 영어(영국)의 0x809 지정하는 경우 함수는 lpGeoData"en-US"도 씁니다.

또 다른 예를 생각해 보십시오. Location 미국의 0xF4 지정되면 GeoType GEO_RFC1766 지정되고 LangId 중국어에 대한 0x04 지정되면 함수는 성공적인 반환 시 "zh-US"를 검색합니다. 지원되는 로캘의 이름이 아닙니다.

애플리케이션에서 GeoType대한 GEO_LCID 지정하면 함수는 언어 식별자를 LCID(로캘 식별자)로 처리합니다. 제공된 지리적 식별자와 어떤 식으로든 연결된 경우 로캘 식별자를 반환하려고 시도합니다.

요구 사항

참고 항목

EnumSystemGeoID

GetGeoInfoEx

국가 언어 지원

국가 언어 지원 함수

SYSGEOTYPE