Share via


GetUserDefaultGeoName 함수(winnls.h)

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

구문

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

매개 변수

[out] geoName

이 함수가 사용자의 기본 지리적 위치에 대해 null로 끝나는 두 문자 ISO 3166-1 또는 숫자 UN M.49 코드를 작성해야 하는 버퍼에 대한 포인터입니다.

[in] geoNameCount

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

반환 값

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

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

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

설명

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

요구 사항

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

참고 항목

GetUserGeoID

국가 언어 지원

국가 언어 지원 함수

SetUserGeoName