SetUserGeoName 함수(winnls.h)

아티클
08/27/2023

현재 사용자의 지리적 위치를 지정된 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를 호출합니다.

반환 코드	설명
ERROR_ACCESS_DISABLED_BY_POLICY	컴퓨터 또는 사용자의 그룹 정책은 이 작업을 금지했습니다.
ERROR_INTERNAL_ERROR	함수에서 예기치 않은 오류가 발생했습니다.
ERROR_INVALID_PARAMETER	매개 변수 값이 잘못되었습니다.

설명

이 함수는 레지스트리에 특정 애플리케이션 대신 특정 사용자의 지리적 위치를 씁니다. 이 작업은 사용자가 실행하는 다른 애플리케이션의 동작에 영향을 줍니다. 일반적으로 사용자가 변경 내용을 명시적으로 요청한 경우에만 이 함수를 호출하지만 순전히 애플리케이션 관련 이유로는 호출하지 않습니다.

두 글자 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