SetUserGeoName 함수(winnls.h)
현재 사용자의 지리적 위치를 지정된 ISO(국제 표준화 기구) 3166-1 코드 또는 숫자 UN(UN) 시리즈 M, 번호 49(M.49) 코드로 설정합니다.
구문
BOOL SetUserGeoName(
[in] PWSTR geoName
);
매개 변수
[in] geoName
현재 사용자에 대해 설정할 지리적 위치에 대한 두 글자 ISO 3166-1 또는 숫자 UN M.49 코드입니다. 운영 체제에서 사용할 수 있는 코드를 얻으려면 EnumSystemGeoNames를 호출합니다.
반환 값
성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다.
이 함수가 성공하지 못하면 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출합니다.
| 반환 코드 | 설명 |
|---|---|
|
컴퓨터 또는 사용자의 그룹 정책은 이 작업을 금지했습니다. |
|
함수에서 예기치 않은 오류가 발생했습니다. |
|
매개 변수 값이 잘못되었습니다. |
설명
이 함수는 레지스트리에 특정 애플리케이션 대신 특정 사용자의 지리적 위치를 씁니다. 이 작업은 사용자가 실행하는 다른 애플리케이션의 동작에 영향을 줍니다. 일반적으로 사용자가 변경 내용을 명시적으로 요청한 경우에만 이 함수를 호출하지만 순전히 애플리케이션 관련 이유로는 호출하지 않습니다.
두 글자 ISO 3166-1 코드에 대한 자세한 내용은 국가 코드 - ISO 3166을 참조하세요. 숫자 UN M.49 코드에 대한 자세한 내용은 통계 사용을 위한 표준 국가 또는 지역 코드(M49)를 참조하세요.
SetUserGeoName 은 Windows 설정 앱과 같은 사용자 설정을 변경하도록 설계된 애플리케이션에서 사용하기 위한 것입니다. 다른 애플리케이션에서는 이 함수를 호출하면 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winnls.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |