GetUserDefaultGeoName 함수(winnls.h)

사용 가능한 경우 사용자의 기본 지리적 위치를 ISO(International Organization for Standardization) 3166-1 두 글자 코드로 검색합니다. 그렇지 않으면 유엔(UN) 시리즈 M, 숫자 49(M.49) 숫자 코드입니다.

통사론

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

[out] geoName

이 함수가 null로 종료된 ISO(International Organization for Standardization) 3166-1 2자 코드 또는 유엔(UN) 시리즈 M, 번호 49(M.49) 숫자 코드를 작성해야 하는 버퍼에 대한 포인터입니다.

[in] geoNameCount

geoName 매개 변수가 지정하는 버퍼의 크기입니다. 이 값이 0이면 함수가 출력 버퍼에 복사할 문자 수만 반환하지만 사용자의 기본 지리적 위치 이름을 버퍼에 쓰지 않습니다.

geoNameCount 매개 변수의 값이 0인 경우 함수가 출력 버퍼에 복사할 문자 수입니다. 그렇지 않으면 함수가 geoName 매개 변수가 지정하는 버퍼에 복사한 문자 수입니다.

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

반환 코드	묘사
ERROR_INVALID_PARAMETER	매개 변수 값이 잘못되었습니다.
ERROR_BADDB	함수가 레지스트리에서 정보를 읽을 수 없습니다.
ERROR_INSUFFICIENT_BUFFER	geoName 매개 변수가 지정하는 버퍼가 문자열에 비해 너무 작습니다.

사용자의 기본 지리적 위치에 대한 ISO 3166-1 코드가 'XX'(코드가 할당되지 않았음을 나타낸)이지만 위치에 UN M.49 코드가 할당된 경우 M.49 코드는 10진수 문자열로 반환됩니다.

사용자의 기본 지리적 위치에 대한 ISO 3166-1 코드가 'XX'(코드가 할당되지 않음)이지만 위치에 UN M.49 코드가 할당된 경우 M.49 코드는 10진수 문자열로 반환됩니다.

두 글자 ISO 3166-1 코드에 대한 자세한 내용은 ISO 3166 국가 코드참조하세요.

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